Visual Studio 2022：将现有项目加入解决方案源代码控制遇阻

步骤1：彻底清理新项目的Git残留文件 #

新项目原本属于独立Git仓库，残留的Git配置会干扰主仓库的识别，必须完全清除：

• 手动删除新项目目录下的.git文件夹、.gitignore、.gitattributes等所有Git相关文件
• 或者用命令行执行（Windows）：

  rd /s /q AddedProject\.git
  del AddedProject\.gitignore AddedProject\.gitattributes
  

  （Linux/macOS）：

  rm -rf AddedProject/.git
  rm -f AddedProject/.gitignore AddedProject/.gitattributes
  

步骤2：检查主仓库的.gitignore规则 #

确认新项目目录没有被主仓库的忽略规则排除：

• 打开解决方案根目录的.gitignore文件，查找是否存在匹配新项目目录名的规则（比如AddedProject/），如有则删除该行
• 用Git命令验证是否被忽略：

  git check-ignore -v AddedProject/
  

  若返回结果，说明存在忽略规则，找到并删除对应规则后重新执行检查。

步骤3：手动将新项目加入主仓库 #

在解决方案根目录执行Git命令强制追踪新项目：

git add AddedProject/
git commit -m "Add new project AddedProject"

执行完成后查看git status，确认工作区已干净，再回到VS刷新Git Changes标签页。

步骤4：重置VS的源代码控制缓存 #

VS的缓存可能导致识别延迟，重置后重新加载：

• 关闭VS，删除缓存目录：%LOCALAPPDATA%\Microsoft\VisualStudio\17.0_*\ComponentModelCache（17.0对应VS2022，星号为你的VS实例ID）
• 或者在VS内操作：菜单栏→工具→选项→源代码控制→Git全局设置→点击「重置所有Git设置」
• 重启VS并重新加载解决方案，检查Git Changes是否能识别新项目的变更。

步骤5：排查Git子模块误配置 #

如果新项目被误识别为子模块，执行以下命令移除：

git submodule deinit -f AddedProject/
rm -rf .git/modules/AddedProject
git rm -f AddedProject

移除后回到步骤3重新添加新项目到主仓库。

内容的提问来源于stack exchange，提问作者Aileron79