『Git学习#1』人生第一次PR

以前个人网站的 CSS / HTML 改过不少，但 GitHub 上别人的项目一直没敢动。最近想试着参与开源，就从最简单的流程走了一遍，没想到第一次 PR 就进主线了。写下来当个记录，也算给同样卡在门外的人一点参考。

一、装环境

先装 Git for Windows。装完把用户名、邮箱配成 GitHub 账号，不然 commit 上对不上人：

# 这两个要和 GitHub 账号一致，不然 commit 记录像别人提的
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的邮箱"

然后是 SSH。生成密钥后，公钥传到 GitHub（Settings → SSH keys），钥匙名随便起，我起的是 miMIMO。测一下通没通：

# 先测连通，再往下走；没通就 push 会一直失败
ssh -T git@github.com
# 看到 Hi 你的用户名 才算通

二、Fork、开分支

项目我选的是 Myriad（自建主页 + 创作工作室）。在 GitHub 页面上点 Fork，到自己名下之后本地克隆：

# 克隆你自己的 Fork，不是原仓库
git clone 你的Fork仓库地址
cd 项目目录

# 原仓库加成 upstream，以后同步方便（可选）
git remote add upstream 原项目地址

# 关键：别在默认分支上改，单独开一条
git checkout -b fix/你的分支名

分支名写清楚一点，比如我这次是 fix/i18n-zh-tw-pairing，回头一眼就知道在修什么。

三、改东西、提交

我这次改的是 frontend/src/i18n/zh-TW.json，把机器人配对界面大约 60 条英文补成繁体中文。用词上「配對碼」「機器人」要统一；同样是私聊，QQ / Telegram 写「私聊」，Discord 写「私訊」，飞书写「單聊」。

改完提交推送：

git add 你改过的文件
# commit 信息写清楚改了什么，review 的人好懂
git commit -m "i18n(zh-TW): complete bot pairing strings"
# 推到自己的 Fork（origin），不是 upstream
git push origin 你的分支名