visual studio 使用 git 需先安装 git for windows 并勾选“add git to the system path”，重启 vs 后在内部终端执行 git --version 验证；再于“工具→选项→源代码管理”中启用 microsoft git 提供程序并重启；克隆或初始化仓库应通过 vs 内置操作完成，推送须用 https 地址及 personal access token。
Visual Studio 能直接用 Git，但必须先装 Git 本身，且不能只靠 VS 安装器勾选“Git for Windows”就完事——很多用户卡在 git 命令不可用、推送失败、或团队资源管理器里压根不显示分支操作，根本原因都是 Git 可执行文件没被正确识别或路径配置错。
确认 Git 已安装且 git 命令全局可用
VS 不会自己装 Git，它只是调用系统 PATH 里的 git.exe。如果打开命令行输 git --version 报“不是内部或外部命令”，VS 的 Git 功能必然瘫痪。
- 推荐重装 Git for Windows，安装时务必勾选 “Add Git to the system PATH”（第二步那个默认选项），别选“Only use Git from Git Bash”
- 装完后重启 VS —— 很多用户跳过这步，导致 VS 仍读不到新 PATH
- 验证方式：在 VS 内部的
终端（Ctrl+`）里直接运行git --version，必须返回版本号，否则后续所有操作都无效
在 VS 选项中启用 Microsoft Git 提供程序
VS 默认可能启用的是旧版 TFVC 插件，Git 集成不会自动激活。
- 路径：
工具 → 选项 → 源代码管理 → 当前源代码管理插件，下拉菜单选Microsoft Git 提供程序 - 改完别点确定就走，要点
确定后再重启 VS——部分设置需冷启动才生效 - 如果列表里没有这个选项，说明 Git 未被识别，回去检查上一步的
git命令是否可用
首次打开项目时避免手动初始化 .git 目录
很多人习惯先用命令行 git init + git add + git commit，再用 VS 打开，结果发现“更改”面板空白、提交按钮灰掉——因为 VS 检测到已有 .git 目录，但没触发内部状态刷新。
- 正确做法：直接在 VS 启动页点
克隆存储库，填入远程 URL（如https://github.com/user/repo.git），VS 会自动完成git clone、加载工作区、并激活 Git UI - 如果是本地已有代码无 Git：在 VS 中打开文件夹后，点击左下角
源代码管理图标（Ctrl+Shift+G），再点顶部的初始化存储库按钮——这比手动命令更可靠，VS 会同步生成.gitignore并注册监听 - 切忌在资源管理器里右键“Git Bash Here”后再进 VS：VS 不感知外部 git 操作，容易出现状态不同步
推送失败常见于 HTTPS 认证和远程地址格式
VS 只支持 HTTPS 协议推送，不支持 SSH（git@github.com:user/repo.git 这种格式会静默失败）。
- 远程地址必须是
https://开头，例如https://github.com/user/repo.git；GitHub 新建仓库页面右侧要手动点 “HTTPS” 标签再复制链接 - 首次推送时，VS 会弹窗要求登录 GitHub 账号（不是密码，是 Personal Access Token）；2021 年起 GitHub 已禁用密码直连，必须去
Settings → Developer settings → Personal access tokens → Generate new token，勾选repo权限 - 如果已配过但推送仍失败，检查
团队资源管理器 → 设置 → Git 设置 → 远程里 origin 的 URL 是否仍是 SSH 格式，手动编辑成 HTTPS
最易被忽略的一点：VS 的 Git 集成高度依赖 .git 目录的完整性。一旦你误删了 .git 或用其他 GUI 工具（如 GitKraken）强行 reset --hard 到某次提交，VS 的“未提交更改”面板可能卡死或显示异常——此时不要硬点提交，先关掉解决方案，用命令行 git status 确认当前状态，再重新打开 VS。
