（个人存档）手把手教导怎么将个人电脑连接到Github

0. 先确认你已经：

• 有一个 GitHub 账户
• 已经新建了一个 私有仓库（Private repository）
  如果还没建，先登录 GitHub → 右上角 “+” → New repository → 填仓库名 → 选 Private → Create repository。

---

1. 安装 Git for Windows（带 Git Bash）
2. 打开浏览器输入：
   https://git-scm.com/download/win
3. 浏览器会自动下载一个文件，名字大概叫 Git-2.xx.x-64-bit.exe（xx 是版本号）。
4. 双击这个 exe → 出现安装向导。
5. 所有页面保持默认即可，只有两个地方要改：
   • “Adjusting your PATH” 页面：选中间那行
     “Git from the command line and also from 3rd-party software”
   • “Configuring the line ending conversions” 页面：选第一项
     “Checkout Windows-style, commit Unix-style line endings”
6. 点 Next → Install → Finish。
7. 验证：在桌面空白处点鼠标右键，菜单里出现 “Git Bash Here” 就说明装好了。

---

2. 创建 SSH 密钥并添加到 GitHub
   2-A. 打开 Git Bash

• 在桌面空白处点右键 → Git Bash Here → 会弹出一个黑色终端窗口。

2-B. 生成密钥（复制下面一整行粘贴到 Git Bash，然后回车）

ssh-keygen -t ed25519 -C "你的邮箱@example.com"

• 它会问你保存路径，直接回车（用默认）。
• 然后问 passphrase（密码），直接回车两次（不设置密码，最省事）。
• 最后会显示 “The key fingerprint is …” 就是成功。

2-C. 查看并复制公钥
继续在 Git Bash 里执行：

cat ~/.ssh/id_ed25519.pub

• 终端会输出一大串，以 ssh-ed25519 开头。
• 选中这整行（鼠标拖拽即可），按 Ctrl + Shift + C 复制。

2-D. 把公钥粘贴到 GitHub

1. 打开浏览器登录 GitHub → 右上角头像 → Settings。
2. 左侧菜单找到 SSH and GPG keys → 右侧绿色按钮 New SSH key。
3. Title 随便填，例如 “MyWin10”。
4. Key 那一栏 粘贴刚才复制的内容。
5. 点击 Add SSH key → 可能需要再输入一次 GitHub 密码确认。

2-E. 测试是否成功
回到 Git Bash，执行：

ssh -T git@github.com

第一次会出现：

The authenticity of host 'github.com (20.205.243.166)' can't be established...

输入 yes 回车。
看到：

Hi 你的用户名! You've successfully authenticated...

说明 SSH 已经配置好。

---

3. 复制仓库 SSH 地址
4. 浏览器回到你的仓库页面（如果关了，登录 GitHub → 右上角头像 → Your repositories → 点进你的仓库）。
5. 绿色 Code 按钮 → 选 SSH → 会看到一个地址形如：

git@github.com:你的用户名/你的仓库名.git

3. 点击右边小图标复制（或手动选中后 Ctrl+C）。

---

4. 克隆（下载）仓库到本地
5. 在 Git Bash 里先进入你想放代码的目录。
   例：把代码放桌面，就输入：

cd /c/Users/$(whoami)/Desktop

（$(whoami) 会自动变成你的 Windows 用户名）
2. 克隆仓库：

git clone git@github.com:你的用户名/你的仓库名.git

• 回车后会出现：

Cloning into '仓库名'...

• 几秒到几十秒后完成。

3. 完成后，桌面会多一个文件夹，名字就是你的仓库名。里面已经有 .git 隐藏文件夹。

---

5. 第一次提交 & 推送（验证流程）
   5-A. 进入项目目录
   继续在 Git Bash 里：

cd 仓库名

（仓库名换成你实际的文件夹名）

5-B. 新建一个测试文件

echo "# 我的第一个私有项目" > README.md

5-C. 添加到暂存区

git add README.md

5-D. 提交

git commit -m "第一次提交：添加 README"

5-E. 推送到 GitHub

git push origin main

• 如果你的仓库默认分支叫 master，就把 main 改成 master。
• 第一次 push 会提示 “Create a pull request…”，无视即可。
• 浏览器刷新仓库页面，能看到 README.md 就说明成功。

---

6. 以后日常开发流程（一句话版）

git pull        # 每天开工前先拉取最新代码
...写代码...
git add .
git commit -m "描述"
git push

---

7. 图形界面替代方案（可选）

• 不想用命令行：安装 GitHub Desktop，登录 GitHub 账号后自动识别 SSH key，点点鼠标即可完成 clone、commit、push。
• 下载地址：https://desktop.github.com

---

8. 常见报错与解决
9. Permission denied (publickey)
   → 检查第 2 步，公钥是否贴错/漏空格。
10. src refspec main does not match any
    → 仓库默认分支是 master，把命令里的 main 改成 master。
11. 需要输入密码？
    → 说明你用的是 HTTPS 地址，换成 SSH 地址即可。

跟着上面 1~8 步逐个点，就可以 100 % 完成私有仓库的克隆与首次推送。