本地项目上传 GitHub 私有库：GitHub CLI 与 Git 原生双方案详解
1. 前言
在开发过程中，如何规范、安全地将本地代码备份到 GitHub 私有库？
本文将对比两种主流操作流程：GitHub CLI 极速流（推荐）和Git 原生稳健流（通用），并解决git init等常见报错。
2. 方案一：最强效率——使用 GitHub CLI（官方推荐）
GitHub CLI (gh) 是官方推出的工具，它将“网页端操作”与“本地命令行”合二为一，是目前最标准的操作。
操作步骤
- 初始化并提交（解决
not a git repository报错的关键）：
gitinitgitadd.gitcommit-m"feat: initial commit"- 一键创建并推送：
gh repo create[项目名]--private--source=.--remote=origin--push关键选择：HTTPS vs SSH
在gh auth login认证时，系统会询问协议选择：
- HTTPS：设置简单，适合新手，但需配合 Token 使用。
- SSH：专业开发者首选。配置一次密钥后永久免密，安全性更高。GH CLI 会引导你自动生成密钥并上传，非常丝滑。
3. 方案二：底层通用——使用 Git 原生命令
如果你不想安装 CLI 工具，或者在无法安装额外软件的服务器上，这是最稳健的流程。
操作步骤
- 本地仓库初始化：
gitinitgitadd.gitcommit-m"Initial commit"- 规范主分支名：
GitHub 目前默认分支名为main，建议同步：
gitbranch-Mmain- 网页端创建仓库：
- 登录 GitHub 网页，点击New repository。
- 必须勾选 Private，且不要勾选 “Initialize with README”（避免合并冲突）。
- 关联并推送：
gitremoteaddorigin https://github.com/用户名/仓库名.gitgitpush-uorigin main4. 深度对比：我该选哪种？
| 特性 | 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) 远程地址查看
随时通过此命令检查你的代码到底关联到了哪个仓库：
gitremote-v6. 总结
- 如果追求极简与效率，请安装GitHub CLI。
- 如果追求通用与底层，请熟练掌握Git 三部曲。
规范化操作不仅能保护代码安全，更能在团队协作中避免不必要的冲突。
如果你觉得这篇文章对你有帮助，欢迎点赞、收藏、关注！有问题请在评论区留言。