
GitHub PAT 教程:新电脑配置指南
新电脑到手后,如何把代码推到 GitHub?这篇教程帮你一次搞定。
为什么要用 PAT?
2021 年 8 月起,GitHub 不再接受命令行密码登录。现在只能用两种方式认证:
| 方式 | 适用场景 |
|---|---|
| Personal Access Token (PAT) | 简单快速,适合个人使用 |
| SSH Key | 更安全,适合多设备/团队 |
对于个人开发者,PAT 是最简单的方式——生成一次,配置好就不用再管。
一、生成 Token
1. 进入设置
登录 GitHub 后,点击右上角你的头像 → Settings
2. 找到 Developer settings
在左侧栏的最底部,点 Developer settings
3. 进入 Token 管理
左侧栏点开 Personal access tokens → Tokens (classic)
然后点右上角的 Generate new token → Generate new token (classic)
4. 配置权限
页面跳转后,按以下内容填写:
| 字段 | 填写 |
|---|---|
| Note | 随便起个名字,比如你的电脑名 my-laptop |
| Expiration | 选 No expiration(永不过期)或 90 days |
| Select scopes | 勾选 repo(整栏打勾)和 workflow |
💡
repo权限让 token 可以读写你的所有仓库,workflow允许推送 GitHub Actions。对个人项目来说这两项就够了。
5. 生成并复制
拉到页面底部,点 Generate token
你会看到一串以 ghp_ 开头的字符串,像这样:
1 | ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
⚠️ 这个页面关掉后就再也看不到了! 立刻点旁边的复制按钮,或者选中后 Ctrl+C,然后粘贴到记事本里临时保存一下。
5. 复制 Token
点 Generate token,你会看到一段像这样的字符串:
1 | ghp_xx…xxxx |
⚠️ 关掉页面就再也看不到了,立刻复制并保存到安全的地方。
二、新电脑配置
1. 安装 git
1 | # CachyOS / Arch Linux |
2. 配置用户名和邮箱
1 | git config --global user.name "SEYYl" |
3. 配置 Token 存储(关键步骤)
1 | git config --global credential.helper store |
这行命令让 git 把用户名和 token 保存到本地 ~/.git-credentials 文件中。只需第一次输入,之后自动认证。
4. 克隆项目并测试
克隆任意一个仓库,第一次会提示输入密码:
1 | git clone https://github.com/你的用户名/你的项目.git |
1 | Username for 'https://github.com': 你的用户名 |
成功后,token 已被保存。后续所有 git push / git pull 都不需要再输入。
验证一下:
1 | cd 你的项目 |
没有报错 → 搞定。
三、日常操作
一切就绪后,正常工作流就是:
1 | # 修改代码 → 提交 → 推送 |
git 会自动用存储的 token 认证,不需要任何额外操作。
四、多台电脑怎么管理
每台新电脑重复「二、新电脑配置」的步骤即可。
| 电脑 | Token 建议名 |
|---|---|
| 主力笔记本 | main-laptop |
| 台式机 | desktop-pc |
| 临时设备 | 用完记得删除 |
如果 token 泄露:去 GitHub → Settings → Developer settings → Tokens → 点 Delete 删除,重新生成一个。
五、常见问题
Q: 提示 remote: Invalid username or password.
原因:token 过期或输入错了。重新生成一个,重新执行 git push 输入新 token。
Q: 想换一台电脑的 token 怎么办?
1 | # 清除已存储的 token |
Q: 用 SSH 是不是更好?
SSH 更安全,但配置步骤多一步(生成密钥 → 贴到 GitHub)。单台个人电脑用 PAT 完全够用。等你想深入了解时再切 SSH 也不迟。
六、一些建议
- 给 Token 起有意义的名字:比如
macbook-airdesktop-ubuntu,方便以后管理 - 定期检查:去 GitHub Token 管理页面看看哪些还在用,不用的及时删掉
- 别把 Token 贴到公开代码里:如果误操作了,立刻去 GitHub 撤销它
一句话总结:
装 git → 设用户名 → 设 credential helper → clone 时输一次 token → 之后就忘了这件事。
