Visual Studio通过MSBuild构建时clang-tidy报错MSB6003如何解决

错误原因定位 #

该报错核心是MSBuild执行构建任务时，找不到指定的clang-tidy.exe可执行文件，可按照以下步骤逐一排查：

error MSB6003: The specified task executable "clang-tidy.exe" could not be run. System.ComponentModel.Win32Exception (0x80004005): The system cannot find the file specified
error MSB6003:    at System.Diagnostics.Process.StartWithCreateProcess(ProcessStartInfo startInfo)
at System.Diagnostics.Process.Start()
at Microsoft.Build.Utilities.ToolTask.ExecuteTool(String pathToTool, String responseFileCommands, String commandLineCommands)
error MSB6003:    at Microsoft.Build.CPPTasks.ClangTidy.ExecuteTool(String pathToTool, String responseFileCommands, String commandLineCommands)
error MSB6003:    at Microsoft.Build.Utilities.ToolTask.Execute()

排查步骤 #

• 首先确认VS的Clang-Tidy组件已完整安装
  打开Visual Studio Installer，切换到「单个组件」标签，搜索C++ Clang 工具和Clang-Tidy，确认对应VS2019 16.11版本的相关组件已勾选安装。安装完成后手动到VS安装目录下查找文件是否存在，默认路径为：C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\Llvm\x64\bin\clang-tidy.exe，注意根据你安装的VS版本（Community/Professional/Enterprise）调整路径前缀。
• 核对项目中的Clang-Tidy路径配置
  右键目标C++项目→属性→代码分析→Clang-Tidy，检查「Clang-Tidy 可执行文件路径」配置项：如果是留空状态，MSBuild会默认调用VS自带的Clang-Tidy路径；如果手动填写了路径，确认路径正确指向clang-tidy.exe所在的文件夹，且路径分隔符、拼写没有错误。
• 排查系统环境变量的LLVM路径冲突
  如果你之前单独安装过官方LLVM工具链，检查系统Path环境变量中是否有其他版本的LLVM路径，且该路径下不存在clang-tidy.exe，会导致MSBuild优先调用该路径下的文件触发报错。可按下Win+R输入cmd打开命令行，执行where clang-tidy.exe，查看输出的路径是否真实存在、是否指向正确的VS自带LLVM目录。
• 临时强制指定路径
  如果以上排查都无问题仍报错，可直接在项目属性的「Clang-Tidy 可执行文件路径」配置项中，填写你找到的clang-tidy.exe完整绝对路径，注意对应x86/x64平台配置要和你构建的目标平台匹配。

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