Visual Studio 连接 Git 仓库需满足三个前提：本地已安装 Git 并被 VS 正确识别（检查工具→选项→Git 路径）、拥有仓库访问权限（注意 MFA 和凭据管理器配置）、打开本地仓库时须通过“Git→本地存储库→打开”显式加载，而非直接“文件→打开文件夹”。
Visual Studio 连接 Git 仓库不是“点一下就完事”的操作，它依赖三个关键前提：本地已安装 Git、VS 能识别该 Git 实例、你有对应仓库的访问权限（尤其是私有仓库）。缺一不可，否则你会卡在克隆失败、凭据弹窗无限循环或“无法解析远程 URL”这类错误上。
确认 Git 已安装且被 Visual Studio 识别
VS 不自带 Git，它调用系统 PATH 中的 git.exe。如果没装或路径不对，所有 Git 功能（包括克隆、提交、推送）都会灰掉或报错 Git not found。
- 打开 VS，进入
工具 > 选项 > 源代码管理 > Git 全局设置，检查Git: Path是否指向有效的git.exe（例如C:\Program Files\Git\bin\git.exe） - 若为空或路径错误，手动填入；若不确定位置，可在命令行运行
where git（Windows）或which git（macOS/Linux）获取真实路径 - 重启 VS 后，在 Git 菜单里能看到“克隆”“本地存储库”等选项，才说明识别成功
克隆远程仓库时遇到凭据问题
连接 Azure Repos 或 GitHub 私有库时，VS 会调用 Git 凭据管理器（GCM），但常见失败场景是：MFA 启用后未完成二次验证、缓存了过期令牌、或企业环境使用自定义域名（如 github.company.com）却没配置 Git host 规则。
Git Pushing
下载
使用约定式提交信息暂存、提交和推送git更改。当用户想要提交和推送更改、提到推送到远程、或要求保存并推送工作时触发。也适用于用户说“推送更改”、“提交并推送”、“推送这个”、“推送到github”或类似git工作流程请求时。
- 首次克隆失败后，不要反复重试——先去 Windows 凭据管理器（控制面板 → 用户账户 → 凭据管理器 → Windows 凭据）删掉所有含
git:或对应域名的条目 - 对于 Azure Repos，确保用的是 Microsoft Entra（原 AAD）账号，而非个人 Outlook.com；MFA 必须在弹出的浏览器页中完成，不能靠手机 App 推送
- 若仓库地址是
https://github.mycompany.com/owner/repo.git，需在终端执行：git config --global url."https://github.mycompany.com/".insteadOf "https://github.com/"，否则 VS 仍会尝试走 github.com 认证
打开已有本地仓库但看不到 Git 状态栏
VS 不会自动激活 Git 支持，即使文件夹里有 .git 子目录。状态栏右下角不显示分支名、未暂存文件数，基本等于 Git 功能“失联”。
- 必须通过
Git > 本地存储库 > 打开本地存储库显式加载，而不是直接用“文件 > 打开文件夹” - 如果该仓库之前由其他工具（如 VS Code 或命令行）初始化过，检查根目录是否存在
.git/config且包含有效[remote "origin"]配置；缺失会导致“推送”按钮禁用 - 状态栏 Git 区域点击后若弹出“未找到 Git 存储库”，说明 VS 读取
.git失败——常见于符号链接目录、OneDrive 同步冲突目录或权限受限路径（如C:\Program Files）
真正容易被忽略的是：VS 的 Git 功能和团队资源管理器（Team Explorer）是两套并行系统。2019 v16.8+ 默认启用新 Git 菜单，但如果你在“团队资源管理器”里连了 TFVC 项目，再切到 Git 仓库，某些上下文（比如分支策略提示、PR 创建入口）可能不会自动刷新。此时关掉团队资源管理器窗格，只用顶部 Git 菜单操作，反而更稳定。
