Visual Studio 2022修改Object File Name编译报错求解决方案

问题详情 #

在Visual Studio 2022 17.6.0 Preview 4.0中，将项目的Object File Name从$(IntDir)修改为$(IntDir)%(RelativeDir)后，编译时报错：

C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Microsoft\VC\v170\Microsoft.CppBuild.targets(1016,5): error MSB3191: Unable to create directory "C:\Source\Repos\Smia\DpGraphs\out\x64\Debug\C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Tools\MSVC\14.36.32522\modules". The given path's format is not supported.

其中$(IntDir)为C:\Source\Repos\Smia\DpGraphs\out\x64\Debug\。

原因分析 #

项目使用C++模块时，编译过程会自动引入系统路径下的std.ixx和std.compat.ixx文件，这类文件的%(RelativeDir)会被解析为绝对路径，导致拼接后的输出路径出现嵌套盘符（如C:\xxx\C:\yyy），违反Windows路径格式规则。而项目内存在同名文件，必须保留%(RelativeDir)来区分不同目录下的编译产物。

可行解决方案 #

方案1：通过条件判断过滤绝对路径的RelativeDir #

利用MSBuild的System.IO.Path静态方法判断%(RelativeDir)是否为绝对路径，仅对项目内的相对路径文件添加%(RelativeDir)，系统模块文件直接使用$(IntDir)作为输出目录。

修改项目文件中的<ClCompile>配置：

<ItemDefinitionGroup>
  <ClCompile>
    <LanguageStandard>stdcpplatest</LanguageStandard>
    <ObjectFileName>$(IntDir)$(if [System.IO.Path]::IsPathRooted('%(RelativeDir)'), '', '%(RelativeDir)')</ObjectFileName>
  </ClCompile>
</ItemDefinitionGroup>

原理：[System.IO.Path]::IsPathRooted()会返回布尔值，若%(RelativeDir)是绝对路径（如系统模块的路径），则不添加该部分，避免路径嵌套；项目内文件的%(RelativeDir)是相对路径，正常拼接以区分同名文件。

方案2：为系统模块文件单独指定输出路径 #

显式针对std.ixx和std.compat.ixx设置独立的ObjectFileName，覆盖全局配置：
在项目文件的<ItemGroup>区域（现有ClCompile项之后）添加：

<ItemGroup>
  <!-- 针对系统C++模块文件单独设置输出目录 -->
  <ClCompile Include="std.ixx" Condition="Exists('$(VCToolsInstallDir)modules\std.ixx')">
    <ObjectFileName>$(IntDir)</ObjectFileName>
  </ClCompile>
  <ClCompile Include="std.compat.ixx" Condition="Exists('$(VCToolsInstallDir)modules\std.compat.ixx')">
    <ObjectFileName>$(IntDir)</ObjectFileName>
  </ClCompile>
</ItemGroup>

原理：通过Condition匹配系统目录下的模块文件，单独设置它们的输出目录为$(IntDir)，不使用%(RelativeDir)，同时保留项目内文件的原有配置。

方案3：移除绝对路径的盘符前缀 #

使用MSBuild的字符串替换功能，移除%(RelativeDir)中的盘符部分，避免路径嵌套：

<ItemDefinitionGroup>
  <ClCompile>
    <LanguageStandard>stdcpplatest</LanguageStandard>
    <ObjectFileName>$(IntDir)$(Replace '%(RelativeDir)', $([System.IO.Path]::GetPathRoot('%(RelativeDir)')), '')</ObjectFileName>
  </ClCompile>
</ItemDefinitionGroup>

原理：$([System.IO.Path]::GetPathRoot())获取%(RelativeDir)的盘符前缀（如C:\），将其替换为空字符串，把绝对路径转换为相对路径片段拼接在$(IntDir)后。

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