GitHub HTTPS 提交代码与个人访问令牌配置指南
🧑 博主简介：ZEEKLOG博客专家，历代文学网（PC端可以访问：https://literature.sinhy.com/#/?__c=1000，移动端可微信小程序搜索“历代文学”）总架构师，15年工作经验，精通Java编程，高并发设计，Springboot和微服务，熟悉Linux，ESXI虚拟化以及云原生Docker和K8s，热衷于探索科技的边界，并将理论知识转化为实际应用。保持对新技术的好奇心，乐于分享所学，希望通过我的实践经历和见解，启发他人的创新思维。在这里，我希望能与志同道合的朋友交流探讨，共同进步，一起在技术的世界里不断学习成长。
技术合作请加本人wx（注明来自ZEEKLOG）：foreast_sea
🔐 GitHub HTTPS 提交代码与个人访问令牌配置指南
除了 SSH 方式，GitHub 确实支持通过 个人访问令牌（Personal Access Token，简称 PAT） 来配合 HTTPS 协议进行身份验证和提交代码。从 2021 年 8 月起，GitHub 不再支持仅用账户密码来通过 HTTPS 操作仓库，个人访问令牌（PAT）就成为了更安全的替代方式。
🔍 HTTPS 与 SSH 提交代码的区别
在开始具体步骤之前，我们先通过一个表格快速了解 HTTPS 和 SSH 两种方式提交代码的主要区别，这能帮助你更好地理解为什么选择 PAT（个人访问令牌）。
| 特性 | HTTPS 地址 (https://github.com/…) | SSH 地址 ([email protected]:…) |
|---|---|---|
| 认证方式 | 个人访问令牌（PAT） 或 GitHub 密码（密码已不再支持命令行操作） | SSH 密钥对 |
| 安全性 | 高（使用令牌，可精细控制权限） | 高 |
| 便利性 | 需配置令牌，但可借助凭证助手缓存 | 一次配置，长期使用 |
| 适用场景 | 适用于所有网络（通常能绕过防火墙和代理限制），偶尔提交代码，或无法使用 SSH 的环境 | 推荐所有开发者，尤其频繁操作 GitHub 的情况 |
| 仓库地址示例 | https://github.com/你的用户名/你的仓库名.git | [email protected]:你的用户名/你的仓库名.git |
💡 简要概括：如果你希望通过 HTTPS 免密提交，核心是生成一个个人访问令牌（PAT），并在第一次推送时用它来代替密码。
📌 重要提示：HTTPS提交的身份验证变化
自2021年8月13日起，GitHub不再支持使用账户密码直接通过命令行进行HTTPS操作（例如 git clone, git push）。你现在必须使用个人访问令牌（PAT） 或 SSH 密钥来代替。PAT 可以看作是一个具有特定权限的应用专用密码。
🛠️ 生成个人访问令牌（PAT）
- 登录GitHub：打开 GitHub 官网，登录你的账户。
- 进入设置：点击页面右上角的你的头像，在下拉菜单中选择 “Settings”。
- 选择开发者设置：在左侧边栏中，找到并点击 “Developer settings”。
- 选择个人访问令牌：在左侧边栏中，点击 “Personal access tokens” → “Tokens (classic)”。
- 生成新令牌：点击 “Generate new token” 按钮，然后选择 “Generate new token (classic)”。
- 配置令牌信息：
- Note：为你的令牌起一个描述性的名字，例如 “My Desktop PC - HTTPS”。
- Expiration：为令牌设置一个有效期。出于安全考虑，建议设置一个期限。你可以选择一段时间，也可以自定义日期。
- Select scopes：选择此令牌的权限范围。为了提交代码到私有仓库，你至少需要勾选 “repo” 权限。如果你还需要操作其他内容，如管理仓库的 Webhook，则需勾选相应权限。权限不是越多越好，按需分配即可。
- 生成令牌：滚动到页面底部，点击 “Generate token” 按钮。
复制并保存令牌：令牌只会在此处显示一次！ 请立即将其复制并妥善保存到安全的地方（如密码管理器）。离开此页面后你将无法再次查看此令牌。
⚙️ 使用 PAT 通过 HTTPS 操作 Git
现在你有了 PAT，就可以在操作远程仓库时用它来代替密码了。
1. 克隆仓库
克隆仓库时，当提示输入用户名和密码时：
- 用户名：输入你的 GitHub 用户名。
- 密码：输入你刚刚生成的 PAT，而不是你的 GitHub 账户密码。
git clone https://github.com/你的用户名/你的仓库名.git 2. 在现有本地仓库中配置远程地址
如果你的本地仓库之前已经关联了一个 HTTPS 的远程地址，通常不需要修改远程地址本身（它仍然是 https://github.com/你的用户名/你的仓库名.git）。你只需要在首次推送时使用 PAT 进行认证即可。
你可以通过以下命令检查当前关联的远程地址：
git remote -v如果输出显示远程地址是 SSH 格式的（[email protected]:...），而你想改用 HTTPS，可以使用以下命令修改：
git remote set-url origin https://github.com/你的用户名/你的仓库名.git 3. 进行提交和推送
在你对代码进行修改后，执行 git add 和 git commit 命令。当你执行 git push 时，Git 会提示你输入用户名和密码。此时：
- Username：输入你的 GitHub 用户名。
- Password：输入你的 PAT。
gitadd.git commit -m"你的提交说明"git push origin main # 或者你的分支名，例如 master💾 配置 Git 凭证助手缓存 PAT
为了避免每次执行 git push 或其他远程操作时都需要重新输入用户名和 PAT，你可以配置 Git 的凭证助手（credential helper） 来在本地缓存你的凭证一段时间。
在 Windows 上：
Git for Windows 通常自带一个叫做 “manager” 的凭证助手。你可以使用以下命令启用全局缓存：
git config --global credential.helper manager 在 macOS 上：
你可以使用 “osxkeychain” 助手将凭证存储在钥匙串中：
git config --global credential.helper osxkeychain 在 Linux 上：
你可以使用 “cache” 助手来临时缓存凭证（默认 15分钟）：
git config --global credential.helper cache 如果你想设置更长的缓存时间（例如 1 小时，3600 秒），可以这样设置：
git config --global credential.helper "cache --timeout=3600"配置凭证助手后，第一次操作远程仓库时输入了用户名和 PAT，系统就会将其缓存起来。在缓存有效期内，后续操作就不再需要手动输入了。
❌ 常见问题与解决
- 提示认证失败（Authentication failed）：
- 请确保你在输入密码时粘贴的是 PAT，而不是你的 GitHub 账户密码。
- 检查 PAT 的权限范围（Scopes） 是否足够（例如，是否勾选了
repo）。 - 检查 PAT 是否已过期。如果过期，你需要重新生成一个新的 PAT。
- 远程地址错误：
- 确保你的远程仓库地址是 HTTPS 格式（以
https://github.com/开头），而不是 SSH 格式（以[email protected]:开头）。你可以通过git remote -v命令查看，并使用git remote set-url origin [新的HTTPS地址]来修改。
- 确保你的远程仓库地址是 HTTPS 格式（以
- 凭证助手不工作：
- 尝试重新输入一次凭证以触发缓存。可以执行一个会触发认证的命令，例如
git fetch。 - 检查 Git 的全局配置
git config --global --list，确认credential.helper是否设置正确。
- 尝试重新输入一次凭证以触发缓存。可以执行一个会触发认证的命令，例如
💎 核心操作流程总结
整个通过 HTTPS 和 PAT 提交代码的过程，可以概括为以下几个关键步骤，你可以按此流程操作：
生成Personal Access Token
PAT复制并妥善保存PAT使用HTTPS URL克隆仓库
或修改现有仓库远程地址进行代码修改并提交
git add & git commit推送提交时使用PAT作为密码可选: 配置凭证助手缓存PAT
