visual studio 中 git 必须绕开默认配置陷阱：未初始化仓库导致“git: no repository”；https 推送因证书问题应改用 ssh over https（端口 443）；分支切换失败常因未暂存修改；冲突解决后需手动暂存文件；远程 url 和 core.autocrlf 配置必须准确。
Visual Studio 里 Git 不是“能用就行”，而是必须绕开几个默认配置陷阱，否则连 git push 都会卡在证书或 SSH 认证上。
VS 状态栏点不动分支？先确认是否真有 Git 仓库
常见现象：底部状态栏显示“Git: No repository”，点击分支名没反应，源代码管理窗口空白。这不是插件没装，而是 VS 根本没识别到 .git 目录。
- 右键解决方案资源管理器顶部项目 → “添加到源代码管理”只对已存在
.git的文件夹有效；若文件夹全新，它不会自动初始化仓库 - 正确做法：在解决方案资源管理器中右键项目根目录 → “打开文件夹所在位置”，在资源管理器地址栏输入
cmd回车，执行git init，再回到 VS 刷新 - 或者直接用 VS 的“Git 更改”窗口（无仓库时自动弹出）→ 点“创建 Git 存储库”，它会在当前打开的文件夹下建
.git
HTTPS 推送失败报 CERT_TRUST_IS_UNTRUSTED_ROOT？别禁用 sslVerify
错误信息里带 CERT_TRUST_IS_UNTRUSTED_ROOT，说明 Windows 证书链不信任 GitHub 的 HTTPS 证书——这在企业内网或某些国产系统上高频出现。临时设 sslVerify = false 虽能过，但等于关掉 TLS 校验，不安全且 VS 后续可能拒绝加载远程分支。
- 首选方案：改用 SSH over HTTPS（端口 443），绕过证书和端口 22 封锁
- 生成密钥时用
ssh-keygen -t ed25519 -C "your@email.com"，不要用 RSA（GitHub 已弃用） -
~/.ssh/config必须写全三行：Host github.com、Hostname ssh.github.com、Port 443，缺一行 SSH 连接就会 fallback 到默认 22 端口并失败 - VS 中修改远程 URL 时，必须从
https://github.com/xxx/yyy.git改成git@github.com:xxx/yyy.git，不能保留https前缀
VS 里切换分支后代码没变？检查工作区是否干净
点击状态栏分支名 → 选新分支 → 界面跳转成功，但文件内容还是旧的。这不是 VS Bug，而是 Git 拒绝覆盖未提交的修改。
- VS 不会自动 stash 你当前的改动。如果暂存区或工作区有变更，
git checkout会被阻断，VS 也不提示（只在输出窗口 Git 面板里刷一行 warning） - 操作前先看“Git 更改”窗口：有未暂存文件？有已暂存但未提交？有 .suo 或 .vs 文件被误加？这些都会导致分支切换静默失败
- 稳妥做法：切换前手动执行
git stash（在 VS 集成终端里敲），切完再git stash pop；VS 自带的“暂存所有更改”按钮不等价于git add -A，它跳过忽略文件但不提示
合并冲突后 VS 不让提交？注意“解决冲突”不是点一下就完事
VS 图形界面标红冲突文件，点“接受传入更改”或“接受当前更改”后，文件看起来没波浪线了，但“提交”按钮仍是灰色，Git 更改窗口里该文件还列在“未暂存的更改”里。
- VS 的“解决冲突”只是帮你删掉
和 <code>>>>>>> branch-name标记，但没执行git add <file></file> - 必须手动右键该文件 → “暂存更改”，或者在 Git 更改窗口勾选它再点“暂存”按钮
- 如果用了“全部接受传入更改”，记得检查是否误删了自己写的逻辑——VS 不做语义判断，只按行文本替换
- 提交消息里建议写明冲突来源，比如
Merge feature/login-ui: resolve conflict in AuthController.cs，方便回溯
最常被忽略的一点：VS 的 Git 集成严重依赖 .git/config 里的 [remote "origin"] 配置是否准确，以及 core.autocrlf 是否与团队一致。这两项一旦错，分支同步、换行符、甚至 diff 显示都会出人意料地歪掉。
