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

1. 前言

在开发过程中，如何规范、安全地将本地代码备份到 GitHub 私有库？
本文将对比两种主流操作流程：GitHub CLI 极速流（推荐）和Git 原生稳健流（通用），并解决git init等常见报错。

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

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

操作步骤

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

gitinitgitadd.gitcommit-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. 本地仓库初始化：

gitinitgitadd.gitcommit-m"Initial commit"

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

gitbranch-Mmain

3. 网页端创建仓库：

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

4. 关联并推送：

gitremoteaddorigin https://github.com/用户名/仓库名.gitgitpush-uorigin main

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

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-v

6. 总结

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

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

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