.NET SDK 不支持目标框架 .NET 6.0 的解决方案

问题描述

当尝试运行或构建针对 .NET 6.0 的应用程序时，可能会遇到以下错误信息：

"The current .NET SDK does not support targeting .NET 6.0. Either target .NET 5.0 or lower, or use a version of the .NET SDK that supports .NET 6.0"

这个错误表示当前环境中安装的 .NET SDK 版本无法识别或支持 .NET 6.0 框架，即使您可能已经安装了正确的 SDK 版本。

解决方案

1. 确认 Visual Studio 版本兼容性

重要提醒

.NET 6.0 仅与 Visual Studio 2022 及更高版本兼容。如果您正在使用 Visual Studio 2019，必须升级到 Visual Studio 2022。

• 下载并安装 Visual Studio 2022
• 确保安装时选择了 .NET 6.0 开发工作负载

2. 检查并安装正确的 .NET SDK

访问 .NET 官方网站下载并安装最新的 .NET 6.0 SDK。

安装后，可以通过命令行验证安装：

dotnet --list-sdks

输出应包含类似以下内容：

6.0.300 [C:\Program Files\dotnet\sdk]

3. 检查并更新 global.json 文件

项目根目录下的 global.json 文件可能锁定了特定的 SDK 版本：

{
  "sdk": {
    "version": "5.0.0", // 需要更新为 6.0.x
    "rollForward": "latestMinor"
  }
}

将版本更新为 6.0.x 或完全删除此文件以使用最新安装的 SDK。

4. 检查解决方案文件中的 Visual Studio 版本

打开 .sln 文件并确保其指向 Visual Studio 2022：

VisualStudioVersion = 17.0.0.0
MinimumVisualStudioVersion = 17.0.0.0

如果显示的是 16.x.x 版本（VS 2019），请更新为上述值。

5. Docker 环境配置检查

如果使用 Docker 构建，请确保 Dockerfile 中的基础镜像使用正确的 .NET 版本：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build

同时确认项目文件 (.csproj) 中的目标框架与 Dockerfile 一致：

<PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
</PropertyGroup>

6. 检查环境变量

某些环境可能设置了 MSBuildSDKsPath 环境变量，强制使用特定版本的 SDK：

# 检查环境变量
echo %MSBuildSDKsPath%  # Windows
echo $MSBuildSDKsPath   # PowerShell/Linux

如果此变量指向旧版 SDK（如 5.0.x），请取消设置或更新它。

7. 清理并重新生成

有时简单的清理和重启可以解决问题：

1. 清理解决方案：dotnet clean
2. 删除 bin 和 obj 文件夹
3. 重启 Visual Studio 或计算机
4. 重新生成解决方案：dotnet build

8. 检查 Mono 设置（仅限特殊情况）

在解决方案属性 > 生成 > 常规中，确保未选中「使用 Mono 上的 MSBuild 生成」选项。

特殊情况处理

CI/CD 环境中的 .NET 6.0

对于 AWS CodeBuild 或其他 CI/CD 系统，可能需要使用特定安装脚本：

phases:
  install:
    commands:
      - /usr/local/bin/dotnet-install.sh --channel STS

多个 global.json 文件

检查整个项目结构中是否存在多个 global.json 文件，它们可能会相互冲突。删除或统一这些文件中的 SDK 版本设置。

总结

遇到 ".NET SDK 不支持目标框架 .NET 6.0" 错误时，通常是由于以下原因之一：

1. 使用不兼容的 Visual Studio 版本（必须使用 VS 2022）
2. global.json 文件锁定了旧版 SDK
3. 环境变量覆盖了 SDK 路径
4. Docker 配置与项目目标框架不匹配
5. 解决方案文件指向旧版 Visual Studio

通过系统性地检查这些区域，您应该能够解决此问题并成功构建 .NET 6.0 应用程序。