EP02. “安装 Git 与首次设定（git config、HTTPS Token、SSH Key）”
🔒 登录后可标记已读- 装好 Git 之后第一件事是设定名字和 Email，不设定的话第一次 commit 就会被 Git 拦下来
- 从 2021 年 8 月起，GitHub 已经不接受用账号密码在指令里 push，要改用 Personal Access Token 或 SSH Key
- Windows 用户推荐装 Git for Windows，会一起装上 Git Bash 和 Git Credential Manager（帮你记住登录）
- 学完你的电脑就能 commit，也能连上 GitHub 推送代码
适用版本
- Git 2.28 以上（
init.defaultBranch设定要 2.28 起才有）；GitHub 网站界面以 2026-09 为准
重点内容
安装 Git
| 系统 | 安装方法 |
|---|---|
| Windows | 到 git-scm.com 下载 Git for Windows，一路 Next；会附带 Git Bash（类 Linux 终端）和 Git Credential Manager |
| macOS | 在 Terminal 打 git --version，没装会提示装 Xcode Command Line Tools；或用 Homebrew：brew install git |
| Linux（Ubuntu） | sudo apt install git |
装好后检查版本：
git --version💡 Windows 安装过程中有一页问默认编辑器，不熟 Vim 的话选 Visual Studio Code 或 Notepad，之后写 commit 说明时比较不会卡住。
首次设定：名字和 Email
每个 commit 都会记下作者，所以一定要先设定：
git config --global user.name "Aiden Tan"
git config --global user.email "aiden@example.com"--global：对这台电脑的所有仓库都生效（存在用户目录的.gitconfig）- 某个项目要用别的身份（例如公司项目用公司 Email）：进那个项目文件夹，去掉
--global再设一次，只对这个仓库生效 - 📌 Email 要跟 GitHub 账号的 Email 一样，GitHub 才会把 commit 算在你的账号下（显示头像、绿格子贡献图）。不想公开真实 Email，可以用 GitHub 提供的
noreply地址（在 GitHub Settings → Emails 里找到）
其他实用设定
| 指令 | 作用 |
|---|---|
git config --global init.defaultBranch main | 新仓库默认分支叫 main（跟 GitHub 一致），不是旧的 master |
git config --global core.editor "code --wait" | commit 说明用 VS Code 编辑 |
git config --global core.autocrlf true | Windows 建议：换行符自动转换，避免跟 Mac/Linux 同事每行都显示有改动 |
git config --list | 列出目前所有设定 |
git config user.name | 查看某一项设定 |
连上 GitHub：两种认证方式
| HTTPS + Personal Access Token | SSH Key | |
|---|---|---|
| 仓库网址长这样 | https://github.com/用户名/仓库.git | git@github.com:用户名/仓库.git |
| 设定难度 | 简单 | 要多做几步 |
| 登录方式 | Token 代替密码 | 电脑里的私钥自动认证 |
| 适合 | 新手、Windows 用户（Credential Manager 会记住） | 常用 Git、多台电脑的人 |
方式一：HTTPS + Personal Access Token
- GitHub 右上角头像 → Settings → 左侧最下面 Developer settings → Personal access tokens
- GitHub 推荐选 Fine-grained tokens（可以只开放指定仓库、指定权限），再按 Generate new token
- 填名字、设定有效期（Expiration）、选择能用的仓库，在权限里把 Contents 设成 Read and write
- 生成后马上复制，离开页面就看不到了
- 第一次 push 时要求输入密码，就贴上这个 Token（Windows 的 Git Credential Manager 通常会直接跳出浏览器登录窗口，之后就会记住）
⚠️ Token 等同密码，不要贴进代码、截图或发给别人。
方式二：SSH Key
第 1 步：生成密钥（一路 Enter 用默认位置即可，也可以设一个 passphrase）
ssh-keygen -t ed25519 -C "aiden@example.com"第 2 步：复制公钥内容（Windows 用 Git Bash）
cat ~/.ssh/id_ed25519.pub第 3 步：贴到 GitHub：Settings → SSH and GPG keys → New SSH key，贴上公钥，按 Add SSH key
第 4 步：测试连线
ssh -T git@github.com看到 Hi 用户名! You've successfully authenticated 就成功了。
📌 .pub 结尾的是公钥，可以贴给 GitHub；没有 .pub 的 id_ed25519 是私钥，绝对不能给别人。
学完你会
- ✅ 装好 Git 并设定名字、Email、默认分支名
- ✅ 分得清 HTTPS Token 和 SSH Key 两种认证方式
- ✅ 能生成 Token 或 SSH Key 连上 GitHub
常见错误
- ❌ push 时输入 GitHub 登录密码：密码认证早已停用，会出现
Authentication failed，要用 Token。 - ❌ Email 跟 GitHub 账号不一致：commit 照样成功，但 GitHub 上不会显示是你的贡献。
- ❌ 把私钥（没有 .pub 的那个）贴到 GitHub：要贴的是
.pub公钥。 - ❌ Token 没设有效期、又给了全部权限：外泄的话影响所有仓库，用 Fine-grained token 只开需要的仓库。
- ❌ Windows 没设
core.autocrlf：跟 Mac 同事协作时，整份文件每一行都显示被改过。
Sources
官方文档：