一、准备工作
1. 安装 Git
（1）访问 Git 官网 下载并安装 Git。 （2）安装完成后，打开终端（Windows 可使用 Git Bash 或 CMD），输入以下命令验证安装成功：
git --version
2. 拥有 GitHub 账号
如果没有账号，前往 GitHub 注册一个免费账号。
二、在 GitHub 上创建私人仓库
- 登录 GitHub，点击页面右上角的 + 号，选择 New repository。
- 在 Repository name 栏输入仓库名称（例如
my-private-project）。 - 可选：添加描述（Description）。
- 在 Visibility 部分选择 Private（私人仓库）。
- 不要勾选 'Initialize this repository with a README' —— 因为我们后续会从本地推送已有项目，保持仓库为空。
- 点击 Create repository 完成创建。
创建后，你会看到一个页面，其中包含远程仓库的地址（HTTPS 或 SSH）。请复制该地址，稍后使用。
三、在本地项目中初始化 Git 仓库
假设你的项目文件夹位于 ~/projects/my-project，进入该目录：
cd ~/projects/my-project
如果该目录尚未被 Git 管理，执行：
git init
这会创建一个 .git 隐藏文件夹，用于版本控制。
四、配置用户信息（首次使用 Git 时需要）
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"
五、添加项目文件并提交
1. 查看当前状态
git status
会显示哪些文件未被追踪。
2. 将项目所有内容添加到暂存区
git add .
.表示添加当前目录下所有文件（包括子目录）。你也可以单独指定文件或使用git add -A添加所有变更。
3. 提交到本地仓库
git commit -m "Initial commit"
请填写有意义的提交信息。
六、关联远程仓库
使用之前复制的 GitHub 仓库地址，添加为远程仓库（通常命名为 origin）：
方式一：使用 HTTPS 地址
git remote add origin https://github.com/你的用户名/my-private-project.git
方式二：使用 SSH 地址（推荐，免重复输入密码）
git remote add origin [email protected]:你的用户名/my-private-project.git
如果你选择 SSH，需确保已经配置好 SSH 密钥（参见下文'附录：配置 SSH 密钥'）。
七、推送代码到 GitHub 私人仓库
1. 推送主分支（默认分支名可能是 master 或 main）
首先查看当前分支名：
git branch
输出如 * master 或 * main。
然后执行推送：
git push -u origin 分支名
例如：
git push -u origin master
-u表示将本地分支与远程分支关联，之后只需git push即可。
2. 输入认证信息（HTTPS 方式）
- 如果使用 HTTPS，Git 会提示输入用户名和密码。但 GitHub 已于 2021 年 8 月 13 日停止支持密码认证，你需要使用 个人访问令牌（Personal Access Token）：
- 在 GitHub 上，点击头像 → Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token (classic)。
- 为令牌起名，勾选
repo权限（私有仓库需要），生成后复制令牌。 - 当 Git 提示输入密码时，粘贴令牌作为密码（用户名仍用你的 GitHub 用户名）。
或者，你可以提前配置 Git 凭证缓存以避免重复输入：
git config --global credential.helper cache
如果使用 SSH 方式且已正确配置密钥，则无需输入密码。
八、验证上传成功
- 刷新 GitHub 仓库页面，应看到所有文件都已上传。
- 检查仓库是否显示为 Private（私有）。
- 可以尝试从另一台设备克隆仓库来确认权限：
git clone 仓库地址
附录：配置 SSH 密钥（推荐）
使用 SSH 可以避免每次推送输入密码，也更安全。
- 将公钥添加到 GitHub：
- 复制输出的内容。
- 在 GitHub 上，点击头像 → Settings → SSH and GPG keys → New SSH key，粘贴公钥并保存。
- 之后使用 SSH 地址添加远程仓库即可。
测试连接：
ssh -T [email protected]
如果看到 'Hi 用户名! You've successfully authenticated…'，说明配置成功。
查看公钥内容：
cat ~/.ssh/id_ed25519.pub
生成 SSH 密钥（如果已有可跳过）：
ssh-keygen -t ed25519 -C "你的邮箱"
一路回车使用默认路径，设置密码（可选）。
附录：创建 .gitignore 文件
如果你希望某些文件（如编译产物、本地配置、依赖目录等）不被上传，可以在项目根目录创建 .gitignore 文件，写入要忽略的文件模式。例如：
node_modules/
.env
*.log
.DS_Store
然后再执行 git add .，这些文件就不会被加入版本控制。
常见问题解决
- 权限不足：检查你是否拥有仓库的写入权限，私人仓库只有你和被邀请的协作者能推送。
- 提交记录中缺少文件：确认执行了
git add .和git commit，并且没有因.gitignore误忽略重要文件。
推送被拒绝（non-fast-forward）：说明远程仓库已有提交（例如你初始化时勾选了 README）。解决办法是先拉取合并：
git pull origin 分支名 --rebase
然后再次推送。