使用 Personal Access Token（PAT）通过 HTTPS 推送到 GitHub（Windows）

从 2021 年起，GitHub 不再支持账号密码直接进行 Git 操作。
如果你用 HTTPS 地址推送代码，需要使用Personal Access Token（PAT）作为“密码”。

一、适用场景

你应该使用这个方案，如果你：

• 不想配置 SSH Key
• 在公司/学校电脑上更习惯 HTTPS
• 想快速完成一次推送

二、创建 Personal Access Token（PAT）

1. 登录 GitHub
2. 进入：Settings→Developer settings→Personal access tokens
3. 选择一种：
   • Fine-grained tokens（推荐）
   • 或Tokens (classic)（旧版）
4. 点击生成 Token

三、权限怎么选（重点）

如果你只是要推送代码到某个仓库，最少需要仓库写权限。

A. Fine-grained token（推荐）

建议配置：

• Resource owner：你的账号
• Repository access：选择目标仓库（或 All repositories）
• Repository permissions：
  • Contents→Read and write（必须）
  • Metadata→ Read（通常自动有）

B. Classic token（旧版）

勾选：

• repo（私有仓库必须）
• 仅公共仓库可用public_repo

Token 生成后只显示一次，请立刻保存。

四、在本地项目里使用 HTTPS 远程地址

进入项目目录：

cd"E:\你的项目路径"

如果项目还没初始化：

gitinitgitadd.gitcommit-m"first commit"gitbranch-Mmain

添加远程仓库（HTTPS）：

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

如果已经有 origin，先改地址：

gitremote set-url origin https://github.com/你的用户名/你的仓库名.git

五、首次 push 时如何输入账号和 Token

执行：

gitpush-uorigin main

终端会提示输入：

• Username：你的 GitHub 用户名
• Password：这里不要填 GitHub 登录密码，填PAT Token

成功后就推送上去了。

六、让 Windows 记住 Token（避免每次输入）

启用 Git Credential Manager（一般 Git for Windows 默认有）：

gitconfig--globalcredential.helper manager

之后再次 push 一次，登录后凭据会被系统安全保存。
后续常用命令：

gitadd.gitcommit-m"更新说明"gitpush

七、检查你现在是否在用 HTTPS

查看远程地址：

gitremote-v

如果看到的是：

https://github.com/...

说明就是 HTTPS 模式。

八、常见问题排查

1）remote: Support for password authentication was removed

原因：你输入了 GitHub 登录密码，而不是 PAT。
解决：重新 push，密码位置输入 Token。

2）fatal: Authentication failed

常见原因：

• Token 复制错了（有空格/少字符）
• Token 过期
• Token 权限不够（没有 Contents write / repo）

解决：重新生成一个 PAT，确认权限后再试。

3）想清除错误缓存的凭据

在 Windows 中打开：

• 控制面板→凭据管理器→Windows 凭据
• 删除与git:https://github.com相关的条目

然后重新git push登录。

4）403或Permission denied to ...

可能是你没有该仓库写权限，或 token 没授权该仓库。
检查仓库权限和 token scope。

九、安全建议（很重要）

• PAT 相当于“密码替代品”，不要截图、不要发群
• 不要把 Token 写进代码、脚本或 README
• 建议设置过期时间（如 30/90 天）
• 怀疑泄露就立即在 GitHub 撤销（Revoke）

十、一套最简命令（可直接复制）

gitinitgitadd.gitcommit-m"first commit"gitbranch-Mmaingitremoteaddorigin https://github.com/你的用户名/你的仓库名.gitgitconfig--globalcredential.helper managergitpush-uorigin main

推送时：

• Username 填 GitHub 用户名
• Password 填 PAT Token