本地项目上传 GitHub 私有库：GitHub CLI 与 Git 原生双方案详解

1. 前言

在开发过程中，如何规范、安全地将本地代码备份到 GitHub 私有库？

本文将对比两种主流操作流程：GitHub CLI 极速流 （推荐）和 Git 原生稳健流 （通用），并解决 git init 等常见报错。

---

2. 方案一：最强效率------使用 GitHub CLI（官方推荐）

GitHub CLI (gh) 是官方推出的工具，它将"网页端操作"与"本地命令行"合二为一，是目前最标准的操作。

操作步骤

1. 初始化并提交 （解决 not a git repository 报错的关键）：

git init
git add .
git commit -m "feat: initial commit"

2. 一键创建并推送：

gh repo create [项目名] --private --source=. --remote=origin --push

关键选择：HTTPS vs SSH

在 gh auth login 认证时，系统会询问协议选择：

• HTTPS：设置简单，适合新手，但需配合 Token 使用。
• SSH ：专业开发者首选。配置一次密钥后永久免密，安全性更高。GH CLI 会引导你自动生成密钥并上传，非常丝滑。

---

3. 方案二：底层通用------使用 Git 原生命令

如果你不想安装 CLI 工具，或者在无法安装额外软件的服务器上，这是最稳健的流程。

操作步骤

1. 本地仓库初始化：

git init
git add .
git commit -m "Initial commit"

2. 规范主分支名 ：
   GitHub 目前默认分支名为 main，建议同步：

git branch -M main

3. 网页端创建仓库：

• 登录 GitHub 网页，点击 New repository。
• 必须勾选 Private，且不要勾选 "Initialize with README"（避免合并冲突）。

4. 关联并推送：

git remote add origin https://github.com/用户名/仓库名.git
git push -u origin main

---

4. 深度对比：我该选哪种？

特性	GitHub CLI (gh)	Git 原生命令
效率	极高，无需切换浏览器	一般，需手动操作网页
自动化	适合集成到脚本或 CI/CD	适合手动微调
学习成本	需了解 CLI 新命令	只要懂 Git 基础即可
适用场景	频繁创建项目的开发者	偶尔上传项目的开发者

---

5. 避坑指南：

(1) .gitignore 必须配置

在 git add . 之前，务必确认根目录下有 .gitignore。

• Python ：过滤 __pycache__、.venv。
• Node.js ：过滤 node_modules、.env。
• Java ：过滤 target/、.idea/。

(2) 权限报错处理

如果遇到 Permission denied (publickey)：

• 说明 SSH 密钥没配对。运行 ssh-keygen 生成密钥，并将 .pub 内容贴到 GitHub 设置里的 SSH and GPG keys 中。

(3) 远程地址查看

随时通过此命令检查你的代码到底关联到了哪个仓库：

git remote -v

---

6. 总结

• 如果追求极简与效率 ，请安装 GitHub CLI。
• 如果追求通用与底层 ，请熟练掌握 Git 三部曲。

规范化操作不仅能保护代码安全，更能在团队协作中避免不必要的冲突。

---

如果你觉得这篇文章对你有帮助，欢迎点赞、收藏、关注！有问题请在评论区留言。