如何在不移动源文件的情况下迁移MSVS解决方案与项目文件？

现有目录结构 #

- [root]
 + solution.sln
 + - common
     + - sources
 + - project1 
     + - sources
     + project1.vsprj 
 + - project2 
     + - src
     + project2.vsprj
 + - project3 
     + - sources
     + project3.vsprj

目标目录结构 #

- [root]
 + - common
     + - sources
 + - project1 
     + - sources
 + - project2 
     + - sources
 + - project3 
     + - sources
 + - build
     + - vs20XX
          + solution.sln
          + project1.vsprj
          + project2.vsprj
          + project3.vsprj

核心结论 #

不可能完全不用编辑任何文件实现这个调整——因为.sln和.vsprj里大量依赖相对路径定位源文件、共用资源和项目关联，移动配置文件后路径必然失效。但完全可以通过脚本批量处理，无需逐个手动编辑文件。

具体操作步骤（附脚本示例） #

1. 搭建目标目录结构

• 在根目录创建build/vs20XX文件夹
• 统一项目源文件目录名：把project2下的src重命名为sources，用PowerShell一键完成：

Rename-Item -Path ./project2/src -NewName sources

2. 迁移配置文件

把所有项目的.vsprj文件和根目录的solution.sln移动到build/vs20XX目录：

# 移动所有.vsprj文件
Get-ChildItem -Path ./ -Recurse -Filter "*.vsprj" | Move-Item -Destination ./build/vs20XX/
# 移动解决方案文件
Move-Item -Path ./solution.sln -Destination ./build/vs20XX/

3. 批量修复路径引用

这是最关键的步骤，需要修复.sln和.vsprj里的相对路径：

修复.sln文件的项目引用路径

原来的.sln里项目路径是project1/project1.vsprj，现在项目文件和.sln同目录，需要把路径替换为文件名：

$slnPath = "./build/vs20XX/solution.sln"
# 用正则替换项目路径，适配多数命名规律的项目
(Get-Content $slnPath) -replace '(".*?",\s*)".+/(.+\.vsprj)"', '$1"$2"' | Set-Content $slnPath

修复.vsprj文件的源文件与共用资源路径

每个.vsprj现在在build/vs20XX，需要把原来指向自身项目源文件的./sources/（或./src/）替换为../../项目名/sources/，同时把指向common的../common/替换为../../common/：

Get-ChildItem -Path ./build/vs20XX -Filter "*.vsprj" | ForEach-Object {
    $projectName = $_.BaseName
    $content = Get-Content $_.FullName -Raw
    # 替换项目自身源文件路径
    $content = $content -replace '\./(sources|src)/', "../../$projectName/sources/"
    # 替换common共用资源路径
    $content = $content -replace '\.\./common/', '../../common/'
    Set-Content $_.FullName $content
}

4. 处理自定义构建步骤（若有）

部分项目的自定义构建步骤里可能包含硬编码的相对路径，需要额外批量检查替换。比如如果构建步骤里有../tools/xxx.exe这类路径，要根据新的目录结构调整为../../../tools/xxx.exe（具体路径根据实际工具位置调整），可以用类似上面的脚本正则替换实现。

注意事项 #

• 操作前务必备份整个根目录，避免脚本失误导致文件丢失或损坏
• 完成所有修改后，打开build/vs20XX/solution.sln检查所有项目是否正常加载，源文件是否都能找到
• 执行一次完整构建，重点验证带自定义构建步骤的项目，确保构建流程正常

内容的提问来源于stack exchange，提问作者Swift - Friday Pie