为何发布.NET项目需在csproj中指定RuntimeIdentifier？
构建背景与问题
目标流程
期望一次性完成以下操作，且不重复构建：
- 构建整个解决方案（含测试项目）
- 运行测试
- 测试通过后将端点应用发布到特定运行时
执行命令
dotnet build MyApp.sln -c Releasedotnet test MyApp.sln --no-build -c Releasedotnet publish MyApp.csproj --no-build -c Release -r win-x64
遇到的错误
初始错误
C:\Program Files\dotnet\sdk\8.0.205\Sdks\Microsoft.NET.Sdk\targets\Microsoft.PackageDependencyResolution.targets(266,5) : error NETSDK1047: Assets file 'MyApp\obj\project.assets.json' doesn't have a target for 'net8.0-windows/win-x64'. Ensure that restore has run and that you have included 'net8.0-windows' in the TargetFrameworks for your project. You may also need to include 'win-x64' in your project's RuntimeIdentifiers. [MyApp.csproj]
当前项目csproj内容：
<Project Sdk="Microsoft.NET.Sdk.Web"> <PropertyGroup> <TargetFramework>net8.0-windows</TargetFramework> </PropertyGroup> </Project>
尝试修复后的错误
在构建与发布之间执行dotnet restore MyApp.csproj -r win-x64后，出现文件缺失错误：
C:\Program Files\dotnet\sdk\8.0.205\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Publish.targets(351,5): error MSB3030: Could not copy the file "MyApp\bin\Release\net8.0-windows\win-x64\MyApp.runtimeconfig.json" because it was not found. [MyApp.csproj]
C:\Program Files\dotnet\sdk\8.0.205\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Publish.targets(351,5): error MSB3030: Could not copy the file "MyApp\bin\Release\net8.0-windows\win-x64\MyApp.deps.json" because it was not found. [MyApp.csproj]
C:\Program Files\dotnet\sdk\8.0.205\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Publish.targets(351,5): error MSB3030: Could not copy the file "bin\Release\net8.0-windows\win-x64\MyApp.xml" because it was not found. [MyApp.csproj]
核心疑问解答
为什么必须配置RuntimeIdentifier？
构建模式的差异
dotnet build默认采用框架依赖、无特定运行时的构建模式，生成的是与平台无关的中间输出（如bin/Release/net8.0-windows下的文件），不会包含针对win-x64的特定资产或编译产物。project.assets.json的作用
该文件是restore阶段生成的依赖清单，记录了项目依赖项针对不同目标框架、运行时的版本和路径。如果构建阶段未指定-r win-x64，restore时不会生成对应win-x64的资产条目，导致publish阶段找不到匹配的依赖资产，抛出NETSDK1047错误。单独restore无法补全构建产物
单独执行dotnet restore -r win-x64只能补全资产清单，但build阶段未针对win-x64编译，不会生成win-x64专属的runtimeconfig.json、deps.json等文件，因此publish阶段会因文件缺失抛出MSB3030错误。
固定RuntimeIdentifier后，publish的意义是什么？
即使在csproj中固定了RuntimeIdentifier，publish依然具备不可替代的核心价值：
打包优化与标准化
将应用、依赖项、运行时文件（自包含发布时）打包为可直接部署的独立目录，移除开发临时文件、调试符号（Release模式默认），生成标准的部署结构，方便自动化部署或容器化。自包含发布支持
通过配置<SelfContained>true</SelfContained>或<PublishSingleFile>true</PublishSingleFile>，publish可将.NET运行时与应用打包为单个可执行文件或独立目录，无需目标机器预先安装.NET环境。自定义部署逻辑
支持通过参数或csproj配置实现个性化部署：- 排除开发依赖项
- 复制额外资源文件、配置文件
- 执行预/后发布脚本
- 生成zip、容器镜像等特定格式的部署包
优化后的构建流程（无重复构建）
若不想在csproj中固定RuntimeIdentifier，可在build阶段直接指定运行时，确保后续test、publish复用同一套构建产物：
# 针对win-x64构建整个解决方案（含测试项目） dotnet build MyApp.sln -c Release -r win-x64 # 复用已构建产物运行测试 dotnet test MyApp.sln --no-build -c Release -r win-x64 # 复用已构建的win-x64产物发布 dotnet publish MyApp.csproj --no-build -c Release -r win-x64
内容的提问来源于stack exchange，提问作者fharreau
