Azure Pipelines中dotnet pack因VCTargetsPath为空报错的解决咨询

使用Azure Pipelines自托管代理构建NuGet包时，纯.NET/.NET Framework项目可正常构建，但包含VS2022 C++项目的解决方案在dotnet pack环节报错：

C:\agents\A1_work\72\s\CPPProject\CPPProject.vcxproj(31,3): error MSB4019: 未找到导入的项目“C:\Microsoft.Cpp.Default.props”。请确认Import声明中的表达式“\Microsoft.Cpp.Default.props”正确，且文件存在于磁盘上。

报错对应的CPPProject.vcxproj代码行：

<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />

dotnet pack的YAML配置：

- task: DotNetCoreCLI@2
  displayName: 'dotnet pack'
  inputs:
    command: custom
    projects: '$(projectFolder)/${{ parameters.projectName }}.csproj'
    custom: pack
    arguments: '--no-build --configuration Release -p:PackageId=$(packageName) -p:Authors="MyCompany" --output "$(Build.ArtifactStagingDirectory)/Package";'

疑问：为何构建步骤无错误，但dotnet pack会出现该报错？如何解决此问题？修改构建服务器的VCTargetsPath环境变量指向VS2022安装目录会影响其他非VS2022项目，而使用.props文件覆盖该值又像是临时的权宜之计。

构建步骤正常是因为C项目构建通常依赖VS自带的MSBuild（比如通过VSBuild任务），这个过程会自动加载VS的C构建环境变量，包括正确的VCTargetsPath。而dotnet pack使用的是.NET CLI自带的MSBuild，它不会自动加载VS的C++专属环境，导致VCTargetsPath变量为空，最终拼接出无效的根目录路径C:\Microsoft.Cpp.Default.props。

1. 在dotnet pack前临时加载VS2022环境 #

通过VsDevCmd@2任务加载VS2022的开发命令行环境，临时注入正确的VCTargetsPath，不会影响全局环境配置：

- task: VsDevCmd@2
  displayName: '加载VS2022开发者命令行环境'
  inputs:
    vsVersion: '17.0' # VS2022对应版本标识为17.x
    arch: 'amd64' # 根据项目架构选择，可选x86/amd64等

- task: DotNetCoreCLI@2
  displayName: 'dotnet pack'
  inputs:
    command: custom
    projects: '$(projectFolder)/${{ parameters.projectName }}.csproj'
    custom: pack
    arguments: '--no-build --configuration Release -p:PackageId=$(packageName) -p:Authors="MyCompany" --output "$(Build.ArtifactStagingDirectory)/Package";'

2. 在dotnet pack参数中直接指定VCTargetsPath #

如果不想加载完整VS环境，可在dotnet pack的参数中直接传入VS2022的C++目标文件路径，根据你的VS版本（社区版/专业版/企业版）调整路径：

- task: DotNetCoreCLI@2
  displayName: 'dotnet pack'
  inputs:
    command: custom
    projects: '$(projectFolder)/${{ parameters.projectName }}.csproj'
    custom: pack
    arguments: '--no-build --configuration Release -p:PackageId=$(packageName) -p:Authors="MyCompany" -p:VCTargetsPath="C:\Program Files\Microsoft Visual Studio\2022\Enterprise\MSBuild\Microsoft\VC\v170" --output "$(Build.ArtifactStagingDirectory)/Package";'

3. 拆分C++项目构建与.NET打包流程 #

先通过VSBuild单独构建C项目，确保环境正确，再执行dotnet pack处理.NET项目，避免dotnet pack触发C项目的重新评估：

- task: VSBuild@1
  displayName: '构建C++项目'
  inputs:
    solution: '**/CPPProject.vcxproj'
    platform: '$(BuildPlatform)'
    configuration: 'Release'

- task: DotNetCoreCLI@2
  displayName: 'dotnet pack'
  inputs:
    command: custom
    projects: '$(projectFolder)/${{ parameters.projectName }}.csproj'
    custom: pack
    arguments: '--no-build --configuration Release -p:PackageId=$(packageName) -p:Authors="MyCompany" --output "$(Build.ArtifactStagingDirectory)/Package";'

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