如何配置.gitignore跟踪VS多项目仓库多层目录下的特定文件

一、通用.gitignore配置 #

在仓库根目录的.gitignore中写入以下规则，无需为每个新项目修改配置：

# 全局忽略所有内容
*
# 保留根目录下的所有项目文件夹（自动适配新增项目）
!*/
# 保留每个项目下的src文件夹及其子结构
!*/src/
# 仅跟踪src目录下的C++源文件和头文件
!*/src/*.cpp
!*/src/*.h

# 单独忽略特定类型/文件
# VS项目相关文件
*.sln
*.vcxproj
*.vcxproj.filters
*.vcxproj.user
# 编译输出目录
bin/
obj/
# 零散无关文本文件
*.txt

规则逻辑说明 #

• *：先全局忽略所有文件和文件夹，这是实现通用规则的核心，避免逐个添加忽略项
• !*/：反转忽略规则，保留根目录下的所有子文件夹（即project1、project2这类项目容器，确保文件结构完整）
• !*/src/：继续反转，保留每个项目下的src文件夹及其子目录，保证目录结构不丢失
• !*/src/*.cpp/!*/src/*.h：仅跟踪src目录下的C++源文件和头文件，符合需求
• 最后列出的特定忽略项，确保VS配置文件、编译产物、无关文件不会被误跟踪

二、解决VS跨盘符路径问题 #

针对两台电脑盘符不同导致的VS加载异常，有两种实用方法：

• 使用相对路径配置项目：打开VS项目属性，将外部库路径、输出路径等所有绝对路径改为相对路径（相对于项目文件夹），这样无论项目在C盘还是D盘，VS都能自动识别正确路径
• 隔离本地VS配置：VS生成的.vs文件夹（包含本地路径配置）已经被.gitignore忽略，每台电脑会自动生成适配当前盘符的本地配置，不会互相干扰

验证配置 #

配置完成后，在仓库根目录执行以下命令检查跟踪状态：

git add .
git status

此时只有各项目的src目录及其下的.cpp/.h文件，以及项目文件夹本身会被列为待提交状态，其余文件均会被忽略。

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