CMake构建C++/C++CLI/C#解决方案时applocal.ps1报错dumpbin未识别

问题根源 #

dumpbin是Visual Studio自带的二进制依赖分析工具，属于VS C++构建工具链的核心组件。vcpkg的applocal.ps1脚本在处理C#项目的依赖复制逻辑时，需要调用它来扫描目标二进制的依赖库，但当前运行脚本的PowerShell环境没有加载VS的工具链环境变量，导致系统找不到dumpbin命令。

这个问题绝对会引发后续问题：脚本无法完成依赖库的自动收集和复制，最终你的C#程序运行时会弹出"找不到xxx.dll"的错误，直接无法启动。

可行的解决方案 #

按推荐程度排序，给你三种靠谱的修复方式：

1. 用VS开发者命令提示符启动构建（最省心）

VS2017自带的Developer Command Prompt for VS 2017会自动帮你配置好所有VS工具链的环境变量，包括dumpbin的路径。操作步骤很简单：

• 开始菜单里找到这个命令提示符并打开
• 切换到你的解决方案根目录
• 用你平时的构建命令启动（比如cmake --build .，或者直接用msbuild构建C#项目）

这样脚本运行时就能直接找到dumpbin，完全不用手动配置。

2. 手动在PowerShell中导入VS环境变量

如果你习惯用普通PowerShell窗口，手动导入VS的环境配置就行：

• 先找到VS2017的vcvarsall.bat，默认路径大概是：
  C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvarsall.bat
  （如果是Pro/Enterprise版本，把路径里的Community换成对应的版本名称）
• 在PowerShell里执行这条命令（注意替换成你自己的路径，最后面的x64是目标架构，按需换成x86/arm）：

  & "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvarsall.bat" x64
  

• 执行完再启动构建，环境就配置好了，dumpbin就能被找到。

3. 修改vcpkg的applocal.ps1脚本（不推荐，迫不得已再用）

如果前两种方法都没法用，你可以直接修改vcpkg的脚本，硬编码dumpbin的路径：

• 打开C:\vcpkg\scripts\buildsystems\msbuild\applocal.ps1
• 在调用dumpbin的代码（大概第60行）前面，添加一段定位逻辑：

  # 替换成你自己的VS2017 MSVC版本路径，比如14.16.27023是VS2017 15.9对应的版本
  $dumpbinPath = "${env:ProgramFiles(x86)}\Microsoft Visual Studio\2017\Community\VC\Tools\MSVC\14.16.27023\bin\Hostx64\x64\dumpbin.exe"
  

• 然后把脚本里所有的dumpbin替换成$dumpbinPath。不过要注意，vcpkg更新时这个脚本会被覆盖，到时候得重新改，所以尽量不用这种方法。

额外检查点 #

• 确认你的VS2017安装了C++开发工作负载，dumpbin是随C++工具链一起安装的，如果没装这个组件，就算配置了路径也找不到工具。
• 如果你用CMake-GUI生成项目，记得选择"Visual Studio 15 2017"作为生成器，并且不要手动指定编译器，这样CMake会自动继承VS的环境变量。

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