新电脑到手后,如何把代码推到 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 tokensTokens (classic)

然后点右上角的 Generate new tokenGenerate 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
2
3
4
5
6
7
8
9
10
11
# CachyOS / Arch Linux
sudo pacman -S git

# Ubuntu / Debian
sudo apt install git

# macOS
brew install git

# Windows
winget install Git.Git

2. 配置用户名和邮箱

1
2
git config --global user.name "SEYYl"
git config --global user.email "你的邮箱@example.com"

3. 配置 Token 存储(关键步骤)

1
git config --global credential.helper store

这行命令让 git 把用户名和 token 保存到本地 ~/.git-credentials 文件中。只需第一次输入,之后自动认证。

4. 克隆项目并测试

克隆任意一个仓库,第一次会提示输入密码:

1
git clone https://github.com/你的用户名/你的项目.git
1
2
Username for 'https://github.com': 你的用户名
Password for 'https://你的用户名@github.com': 粘贴你的token在这里

成功后,token 已被保存。后续所有 git push / git pull 都不需要再输入。

验证一下:

1
2
3
4
5
cd 你的项目
echo "# test" >> README.md
git add .
git commit -m "test push"
git push

没有报错 → 搞定。


三、日常操作

一切就绪后,正常工作流就是:

1
2
3
4
# 修改代码 → 提交 → 推送
git add .
git commit -m "做了什么改动"
git push

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
2
3
4
5
# 清除已存储的 token
rm ~/.git-credentials

# 下次 push 时重新输入新 token
git push

Q: 用 SSH 是不是更好?

SSH 更安全,但配置步骤多一步(生成密钥 → 贴到 GitHub)。单台个人电脑用 PAT 完全够用。等你想深入了解时再切 SSH 也不迟。


六、一些建议

  • 给 Token 起有意义的名字:比如 macbook-air desktop-ubuntu,方便以后管理
  • 定期检查:去 GitHub Token 管理页面看看哪些还在用,不用的及时删掉
  • 别把 Token 贴到公开代码里:如果误操作了,立刻去 GitHub 撤销它

一句话总结:
装 git → 设用户名 → 设 credential helper → clone 时输一次 token → 之后就忘了这件事。