1. 简介
Git 是一个强大的版本控制系统，用于管理和追踪文件变更，是软件开发中不可或缺的工具。借助 Git，团队成员无论身处何地，都可以通过网络访问和修改代码，实现无缝协作。目前，开发者最常使用的 Git 集成开发环境（IDE）之一是 Visual Studio Code（VS Code）。然而，对于刚接触 Git 和 VS Code 的用户来说，配置 Git 可能会遇到一些挑战。
在本指南中，我们将重点讲解如何在 VS Code 中配置 Git 凭据，这是将两者集成的第一步。我们将先介绍如何配置 Git 的 credential helper（凭据助手），然后讲解如何使用 GitHub 的 Token-based Authentication（令牌认证），最后还会列出一些常见的认证问题及解决方案。
2. 为什么 VS Code 会提示输入 Git 凭据
VS Code 在执行 Git 操作（如拉取更新、推送提交）时会提示输入凭据，这是因为 Git 在与远程服务器交互时需要进行身份验证以确保安全性。简而言之，VS Code 频繁提示输入 Git 凭据是为了验证用户身份，并确保其对仓库具有操作权限。
常见的几种触发凭据提示的场景包括：
- HTTPS 远程地址：如果仓库使用 HTTPS 协议连接，每次执行
git pull、git push或git fetch时都需要输入用户名和密码。 - 未配置 SSH Key 的 SSH 地址：如果使用 SSH 协议但未将公钥添加到 Git 服务器，VS Code 也会提示输入密码。
为避免频繁输入凭据，官方建议使用 Git 的 credential helper 来缓存或存储凭据。接下来我们就会讲解如何配置。
3. 配置 Git 的 Credential Helper
配置 Git 的 credential helper 是在 VS Code 中简化 Git 凭据输入流程的一种方式。它可以让 Git 暂时记住凭据，避免重复输入。我们可以通过 VS Code 的集成终端执行 Git 命令来完成配置。
打开终端的方法是：点击菜单 Terminal > New Terminal，然后在终端中输入相关命令。
以下是两种常用的 credential helper 配置方式。
3.1. 内存缓存（Memory Cache）
这种方式会将凭据缓存在内存中，适合短期使用。使用 git config 命令启用：
$ git config --global credential.helper cache
默认缓存时间为 15 分钟。如需延长缓存时间，比如设置为 1 小时（3600 秒）：
$ git config --global credential.helper 'cache --timeout=3600'
这样配置后，Git 会在指定时间内自动使用缓存凭据，超时后再次提示输入。
3.2. 凭据存储（Store Helper）
这种方式会将凭据明文保存在本地文件中，适合长期使用。⚠️ 注意：只建议在个人安全设备上使用此方式，不推荐用于共享或公共计算机。
启用命令如下：
$ git config --global credential.helper store
启用后，Git 会在首次输入凭据后将其永久保存，下次操作时自动使用。
3.3. 验证配置是否生效
可通过以下命令查看当前配置的 credential helper：
$ git config --global --get credential.helper
输出应类似以下内容，表示配置成功：
cache --timeout=3600
4. GitHub 的 Token-based 认证（Personal Access Token, PAT）
随着安全策略的加强，GitHub 已不再支持使用密码进行远程 Git 操作。✅ **现在必须使用 Personal Access Token (PAT)**，以增强安全性。
本节将介绍如何生成 PAT 并在 Git 中使用它。
4.1. 生成 Personal Access Token
登录 GitHub 后，进入 Settings > Developer settings > Personal access tokens，然后点击 Generate new token。
生成时需选择合适的权限（如 repo、gist 等），生成后务必立即复制保存，因为页面刷新后就无法再次查看该 Token。
4.2. 将 Token 添加到 Git
在 VS Code 终端中执行 git clone 命令：
$ git clone https://github.com/username/repo.git
当提示输入密码时，粘贴你刚刚生成的 PAT。GitHub 会识别该 Token 并完成认证。
4.3. 结合 Credential Helper 使用 Token
为了避免重复输入 Token，可以结合前文提到的 credential helper 使用。这样 Git 会在本地缓存或存储 Token，后续操作自动使用，无需再次输入。
4.4. 更新 Token
当 Token 过期或需要更换时，回到 GitHub 设置中撤销旧 Token，并生成新的 Token 替换即可。Git 会根据配置自动使用新 Token。
5. 常见问题及解决方法
即使配置了凭据，有时在 VS Code 中执行 Git 操作时仍会遇到问题。以下是一些常见错误及解决方案。
5.1. Authentication Failed（认证失败）
可能是凭据错误或 Token 已过期。✅ 解决方法如下：
- 检查 Token 是否正确；
- 如需更新，前往 GitHub 重新生成；
- 若使用了 credential helper，可清除缓存：
$ git credential-cache exit
下次操作时会重新提示输入凭据。
5.2. VS Code 无法识别 Token
可能是 Git 版本过旧。✅ 检查 Git 版本：
$ git --version
如版本过低，建议前往 Git 官网下载最新版本。
5.3. Credential Helper 配置冲突
若切换了 credential helper（例如从 cache 改为 store）后仍提示问题，建议重新执行配置命令以刷新设置。
5.4. Credential Helper 无效
若配置后仍频繁提示输入密码，可能是 VS Code 的 git.autofetch 功能在后台自动拉取更新导致。
✅ 解决方法：在 VS Code 设置中禁用该功能：
{
"git.autofetch": false
}
路径为：File > Preferences > User Settings。
6. 总结
在本篇文章中，我们讲解了如何在 VS Code 中配置 Git 凭据，包括：
- 为什么 VS Code 会提示输入 Git 凭据；
- 如何配置 Git 的 credential helper；
- 如何使用 GitHub 的 Personal Access Token；
- 常见认证问题及解决方案。
✅ 配置 Git 凭据不仅能提升开发效率，还能增强代码仓库的安全性。尤其是 GitHub 强制使用 Token 认证后，合理配置 credential helper 成为保障顺畅开发体验的关键步骤。只需简单几步，你就可以让 VS Code 和 Git 协作更高效、更安全。