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 三部曲。
规范化操作不仅能保护代码安全,更能在团队协作中避免不必要的冲突。
如果你觉得这篇文章对你有帮助,欢迎点赞、收藏、关注!有问题请在评论区留言。