使用.NET Core 7执行dotnet build -c development时遇MSB4126错误求助

错误原因 #

这个报错的核心是解决方案（.sln文件）层面没有定义development配置，而非项目文件的问题。当你在解决方案根目录执行dotnet build时，MSBuild会优先检查解决方案预定义的「配置+平台」组合，你的项目文件里虽然有development配置的映射，但解决方案本身没这个配置，就会触发MSB4126错误。

解决方法 #

方法1：直接针对项目文件构建 #

跳过解决方案的配置检查，直接指定项目文件路径执行构建：

dotnet build YourWebProject.csproj -c development

如果你的命令是在项目目录下执行，也可以简化成：

dotnet build -c development --project .

方法2：给解决方案添加development配置 #

可视化操作（Visual Studio）

1. 右键解决方案 → 属性 → 配置属性 → 配置管理器
2. 在「活动解决方案配置」下拉框选择「<新建...>」
3. 输入development，选择复制「Debug」的设置，勾选「创建新项目配置」，确定保存即可。

手动编辑.sln文件

找到解决方案文件里的GlobalSection(SolutionConfigurationPlatforms)和GlobalSection(ProjectConfigurationPlatforms)节点，添加对应的配置条目：

GlobalSection(SolutionConfigurationPlatforms) = preSolution
    Debug|Any CPU = Debug|Any CPU
    Release|Any CPU = Release|Any CPU
    development|Any CPU = development|Any CPU  # 添加这一行
EndGlobalSection

# 然后找到对应项目的配置节点，添加以下内容（替换{ProjectGUID}为你项目的实际GUID）
GlobalSection(ProjectConfigurationPlatforms) = postSolution
    {ProjectGUID}.development|Any CPU.ActiveCfg = development|Any CPU
    {ProjectGUID}.development|Any CPU.Build.0 = development|Any CPU
EndGlobalSection

额外优化：调整项目文件的配置默认值 #

你项目文件里的<Configuration Condition="'$(Configuration)' == 'Debug'">development</Configuration>逻辑有点反直觉，它会把传入的Debug配置强制改成development，建议改成默认配置的设置，这样未指定配置时默认用development：

<PropertyGroup>
    <Configuration Condition=" '$(Configuration)' == '' ">development</Configuration>
</PropertyGroup>

关于“之前能运行”的推测 #

大概率是之前执行命令时的上下文不同：

• 之前是在项目目录下执行（默认加载项目文件而非解决方案）
• 之前解决方案里存在development配置，后来被误删除或修改了

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