升级VS2022后远程Linux项目编译失败：ClCompile目标报错

我有一个闲置数月的Linux项目，此前用VS2019创建，通过Windows端Visual Studio远程Linux构建正常。升级到VS2022（17.3.6）后，构建时出现无明确有效信息的报错，核心为ClCompile构建目标失败，基础报错如下：

Target ClCompile:
  C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Microsoft\VC\v170\Application Type\Linux\1.0\Linux.targets(399,5): error : Exception has been thrown by the target of an invocation.
  C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Microsoft\VC\v170\Application Type\Linux\1.0\Linux.targets(399,5): error :    at System.RuntimeMethodHandle.InvokeMethod(Object target, Object[] arguments, Signature sig, Boolean constructor)

{ many lines omitted, see below for complete log }

Done building target "ClCompile" in project "{PROJECT}.vcxproj" -- FAILED.
Done building project "{PROJECT}.vcxproj" -- FAILED.
Build FAILED.

已尝试操作 #

• 更新GCC、GDB、GDBServer到对应版本
• 重启Windows和Linux机器
• 创建"hello world"空项目，可正常构建运行

软硬件版本信息 #

Windows端 #

• Microsoft Visual Studio Professional 2022（64位）- 版本17.3.6
• Windows 10 版本22H2

Linux端 #

• Ubuntu 20.04.2 LTS
• GCC 9.4.0
• GDB 10.2

详细诊断日志 #

开启诊断级构建日志后，ClCompile失败前的完整输出如下：

Target "ClCompile" in file "C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Microsoft\VC\v170\Application Type\Linux\1.0\Linux.targets":
  Using "MultiMakeCl" task from assembly "C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Microsoft\VC\v170\Application Type\Linux\1.0\Microsoft.Build.Linux.Tasks.dll".
  Task "MultiMakeCl"
    Task Parameter:RemoteIntermediateDir=/home/{user}/{ProjectName}/vsLinux/{ProjectName}/obj/x64/Tests
    Task Parameter:IntermediateDir=C:\{user}\{ProjectName}\LinuxSolution\obj\x64\Tests\
    Task Parameter:RemoteProjectDir=/home/{user}/{ProjectName}/vsLinux/{ProjectName}/LinuxSolution/
    Task Parameter:ProjectDir=C:\{user}\{ProjectName}\LinuxSolution\
    Task Parameter:RemoteOutputDir=/home/{user}/{ProjectName}/vsLinux/{ProjectName}/bin/x64/Tests
    Task Parameter:RemoteTarget=-1151915053;192.168.0.12 (username=, port=22, authentication=Password)
    Task Parameter:
        ImportedProjects=
            C:\dev\HotLink\LinuxSolution\HotLink.vcxproj
            C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Current\Bin\amd64\Microsoft.Xaml.targets
            C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Microsoft\NuGet\17.0\Microsoft.NuGet.targets
    Task Parameter:
        Sources=
{ very long list of each source file and all project settings related to them }

Task Parameter:OutputDir=C:\dev\{ProjectName}\LinuxSolution\bin\x64\Tests\
    Task Parameter:EnableASAN=False
    Task Parameter:IncludePath=C:\dev\{ProjectName}\LinuxSolution\..\thirdParty\;C:\dev\{ProjectName}\LinuxSolution\..\src\;;;

C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Microsoft\VC\v170\Application Type\Linux\1.0\Linux.targets(399,5): error : Exception has been thrown by the target of an invocation.
  C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Microsoft\VC\v170\Application Type\Linux\1.0\Linux.targets(399,5): error :    at System.RuntimeMethodHandle.InvokeMethod(Object target, Object[] arguments, Signature sig, Boolean constructor)
  C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Microsoft\VC\v170\Application Type\Linux\1.0\Linux.targets(399,5): error :    at System.Reflection.RuntimeMethodInfo.UnsafeInvokeInternal(Object obj, Object[] parameters, Object[] arguments)
  C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Microsoft\VC\v170\Application Type\Linux\1.0\Linux.targets(399,5): error :    at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)
  C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Microsoft\VC\v170\Application Type\Linux\1.0\Linux.targets(399,5): error :    at System.Reflection.RuntimePropertyInfo.SetValue(Object obj, Object value, Object[] index)
  C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Microsoft\VC\v170\Application Type\Linux\1.0\Linux.targets(399,5): error :    at Microsoft.Build.Linux.Tasks.MultiMakeCl.PopulateTaskFromSourceItem(ITaskItem source, MakeClCommandLine schedulingTask, PropertyInfo[] propertyInfo)
  C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Microsoft\VC\v170\Application Type\Linux\1.0\Linux.targets(399,5): error :    at Microsoft.Build.Linux.Tasks.MultiMakeCl.ExecuteTool()
  C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Microsoft\VC\v170\Application Type\Linux\1.0\Linux.targets(399,5): error :    at Microsoft.Build.Linux.Tasks.RemoteToolTask.Execute()
Done building target "ClCompile" in project "{PROJECT}.vcxproj" -- FAILED.

Done building project "{PROJECT}.vcxproj" -- FAILED.

Build FAILED.

排查与解决方法 #

根据错误栈（MultiMakeCl.PopulateTaskFromSourceItem中反射设置属性失败），问题大概率出在VS2022对旧项目的兼容性处理上，以下是可尝试的方案：

1. 清理项目缓存与远程文件

   • 删除Windows端项目的obj、bin目录，以及Linux端远程目录（/home/{user}/{ProjectName}/vsLinux/）下的所有文件，重新触发远程同步构建。
   • 在VS中执行项目>清理解决方案，再重新构建。

2. 检查项目属性的兼容性问题

   • 对比空项目与现有项目的属性差异：重点检查C/C++>常规中的包含路径、预处理器定义，链接器>输入等设置，尤其是带有特殊字符或相对路径的配置。
   • 尝试将项目属性重置为默认值，再逐步恢复自定义配置，定位引发异常的具体设置项。
   • 检查是否存在VS2019支持但VS2022已废弃的编译选项，比如某些旧版GCC专属参数，替换为兼容的新选项。

3. 修复或重新生成项目文件

   • 手动编辑.vcxproj文件，移除可能残留的VS2019专属配置节点（比如旧版Linux构建相关的PropertyGroup）。
   • 新建一个VS2022的Linux项目，将现有源码和资源文件逐步迁移过去，验证是否能正常构建。

4. 更新VS2022到最新版本
   当前使用的17.3.6是较旧的版本，后续更新修复了不少远程Linux构建的兼容性问题，升级到最新稳定版后再尝试构建。

5. 检查文件路径与权限

   • 确保Windows端项目路径和Linux端远程路径中没有中文、空格或特殊字符，避免同步或构建时出现解析错误。
   • 确认Linux端远程用户对项目目录拥有完整的读写权限，可执行chmod -R 755 /home/{user}/{ProjectName}/vsLinux/调整权限。

6. 启用更详细的日志定位问题源
   执行MSBuild命令时添加更详细的参数：

   msbuild YourProject.vcxproj /t:Rebuild /v:diag > build.log
   

   从日志中找到Sources列表中最后一个被处理的文件，单独编译该文件验证是否存在问题，逐步缩小范围。

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