使用 Personal Access Token(PAT)通过 HTTPS 推送到 GitHub(Windows)

张开发
2026/5/19 4:48:59 15 分钟阅读
使用 Personal Access Token(PAT)通过 HTTPS 推送到 GitHub(Windows)
从 2021 年起GitHub 不再支持账号密码直接进行 Git 操作。如果你用 HTTPS 地址推送代码需要使用Personal Access TokenPAT作为“密码”。一、适用场景你应该使用这个方案如果你不想配置 SSH Key在公司/学校电脑上更习惯 HTTPS想快速完成一次推送二、创建 Personal Access TokenPAT登录 GitHub进入Settings→Developer settings→Personal access tokens选择一种Fine-grained tokens推荐或Tokens (classic)旧版点击生成 Token三、权限怎么选重点如果你只是要推送代码到某个仓库最少需要仓库写权限。A. Fine-grained token推荐建议配置Resource owner你的账号Repository access选择目标仓库或 All repositoriesRepository permissionsContents→Read and write必须Metadata→ Read通常自动有B. Classic token旧版勾选repo私有仓库必须仅公共仓库可用public_repoToken 生成后只显示一次请立刻保存。四、在本地项目里使用 HTTPS 远程地址进入项目目录cdE:\你的项目路径如果项目还没初始化gitinitgitadd.gitcommit-mfirst commitgitbranch-Mmain添加远程仓库HTTPSgitremoteaddorigin 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 模式。八、常见问题排查1remote: Support for password authentication was removed原因你输入了 GitHub 登录密码而不是 PAT。解决重新 push密码位置输入 Token。2fatal: Authentication failed常见原因Token 复制错了有空格/少字符Token 过期Token 权限不够没有 Contents write / repo解决重新生成一个 PAT确认权限后再试。3想清除错误缓存的凭据在 Windows 中打开控制面板→凭据管理器→Windows 凭据删除与git:https://github.com相关的条目然后重新git push登录。4403或Permission denied to ...可能是你没有该仓库写权限或 token 没授权该仓库。检查仓库权限和 token scope。九、安全建议很重要PAT 相当于“密码替代品”不要截图、不要发群不要把 Token 写进代码、脚本或 README建议设置过期时间如 30/90 天怀疑泄露就立即在 GitHub 撤销Revoke十、一套最简命令可直接复制gitinitgitadd.gitcommit-mfirst commitgitbranch-Mmaingitremoteaddorigin https://github.com/你的用户名/你的仓库名.gitgitconfig--globalcredential.helper managergitpush-uorigin main推送时Username 填 GitHub 用户名Password 填 PAT Token

更多文章