如何构建包含NET5.0与C/C++项目的混合解决方案？

核心结论 #

包含.NET 5+和C/C项目的混合解决方案完全可以正常构建，你当前的分步构建思路方向正确，但缺少环境初始化步骤导致C编译报错，同时存在更简单的统一构建方案。

C1083错误根因 #

你直接在命令行调用msbuild编译C项目时，没有初始化VC编译环境。Visual Studio运行时会自动加载对应架构的头文件、Windows SDK路径、编译工具链等环境变量，而裸命令行下的msbuild没有这些变量，自然找不到标准头文件。
原msbuild无法识别.NET5项目的原因是你调用的是旧版本msbuild，没有安装.NET 5 SDK对应构建组件，不支持SDK风格的.NET项目。dotnet cli原生不支持vcxproj类型的C++项目，所以无法完成混合构建。

可行构建方案 #

方案1：修正你的分步构建流程

• 先初始化VC++编译环境：执行对应Visual Studio版本的开发者命令行脚本，以VS2022社区版为例，默认路径下执行命令："C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\Tools\VsDevCmd.bat" -arch=x64，可根据需求替换架构参数为x86/arm64
• 编译C++项目：执行msbuild xxx.vcxproj /p:Configuration=Release /p:Platform=x64，指定和后续.NET项目一致的配置与平台
• 发布.NET5项目：执行dotnet publish 你的项目.csproj -c Release -r win-x64 --no-self-contained -o 发布路径，确保运行时架构和C++项目匹配

方案2：更简洁的统一构建方案（推荐）

无需分步，直接使用正确版本的msbuild一次性构建整个解决方案：

• 前置条件：安装VS2019 16.8+ / Visual Studio Build Tools，且勾选.NET 5 SDK、桌面C++开发、对应版本Windows SDK组件
• 打开对应版本的Visual Studio Developer Command Prompt，执行命令：msbuild 你的解决方案.sln /p:Configuration=Release /p:Platform=x64 /p:DeployOnBuild=true /p:PublishDir=发布路径
• 该命令会自动识别所有.NET5和C++项目，按照依赖顺序完成编译和.NET项目发布，不需要手动处理构建顺序

注意事项 #

• 所有项目的配置、平台参数必须统一，避免出现.NET项目为Any CPU、C++项目为x64的不匹配情况
• 若C++项目被.NET项目直接引用，msbuild会自动处理依赖关系，无需手动调整构建顺序
• CI环境下不需要安装完整Visual Studio，仅安装对应版本的Visual Studio Build Tools并勾选所需组件即可

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