Skip to main content

新建私有GitHub项目的简单流程

在 macOS 上，从 0 新建一个 private GitHub 项目并能正常 commit / push 的标准流程。这是 GitHub 官方支持、最省事、最少坑 的做法。

我分成 「推荐流程（用 gh）」 和 「你可能踩坑的点」 两部分。

✅ 推荐流程（强烈建议，用 GitHub CLI）​

0️⃣ 前提检查（一次性）​

gh --version
git --version

1️⃣ 登录 GitHub（只需一次）​

gh auth login

推荐选择：

  • GitHub.com

  • HTTPS

  • Authenticate via browser

  • Yes（configure git to use GitHub CLI credentials）

检查是否成功：

gh auth status

看到：

✓ Logged in to github.com as xxx
✓ Git operations for github.com configured to use gh

说明 Git push 也一起配置好了 ✅

2️⃣ 本地新建项目目录​

mkdir my-project
cd my-project
git init

（可选）初始化基础文件：

echo "# my-project" > README.md
git add .
git commit -m "init"

3️⃣ 用 gh 创建 private repo（关键）​

gh repo create my-project --private

你会看到提示，选择：

  • Push an existing local repository

  • 选当前目录

这一步会自动帮你做三件事 👇

✅ 在 GitHub 上创建 private repo
✅ 设置好 origin remote（HTTPS）
✅ 直接把代码 push 上去

4️⃣ 以后正常开发即可​

git add .
git commit -m "feat: xxx"
git push

不需要再登录，不需要 token，不需要输密码。

🧠 如果你不想用交互式，也可以一条命令​

gh repo create my-project \
  --private \
  --source=. \
  --remote=origin \
  --push

❗常见坑（提前避雷）​

❌ 坑 1：先在 GitHub 网页建 repo，再本地 git init​

不是不能用，只是步骤更多，容易少一步 remote。

如果你已经这么做了，必须手动：

git remote add origin https://github.com/xxx/my-project.git
git push -u origin main

❌ 坑 2：HTTPS + 没让 gh 配置 Git​

表现为：

fatal: Authentication failed

解决：

gh auth login
# 重新来，选 Yes

或：

gh auth setup-git

❌ 坑 3：用 SSH，但 SSH key 没配​

Permission denied (publickey)

如果你想走 SSH，我也可以给你一套 macOS 官方推荐 SSH 流程。

📌 最终一句话版本​

最省事流程：

gh auth login
git init
gh repo create xxx --private --source=. --push