# .NET SDK

Microsoft 免费开源的开发工具包，包含 CLI 和匹配的运行时，可用于构建、测试和发布 .NET 应用。

> 这是 OpenNavo 上 .NET SDK 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/dotnet-sdk>

- **最新版本**: `11.0.100`
- **开发者**: Microsoft, .NET Foundation and contributors
- **主页**: <https://www.microsoft.com/net/core#macos>
- **分类**: [开发工具](https://opennavo.com/zh/categories/developer-tools)
- **安装**: `brew install --cask dotnet-sdk`
- **近 30 天安装**: 21,192
- **Homebrew**: 可以安装，由 Homebrew 更新
- **下载地址**: <https://builds.dotnet.microsoft.com/dotnet/Sdk/11.0.100/dotnet-sdk-11.0.100-osx-arm64.pkg>
- **SHA-256**: `96b96a7d7ec00b2397d575ffa7acfe685d7261fe2a2719d80131e5f8003deaf9`
- **附带命令**: dotnet, dnx
- **安装包**: dotnet-sdk-11.0.100-osx-arm64.pkg

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "pkgutil": [
            "com.microsoft.dotnet.*11.0*arm64",
            "com.microsoft.dotnet.sharedhost*arm64",
            "com.microsoft.netstandard.pack.targeting.*"
          ]
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "pkg": [
        "dotnet-sdk-11.0.100-osx-arm64.pkg"
      ]
    },
    "phase": "install",
    "sources": [
      "dotnet-sdk-11.0.100-osx-arm64.pkg"
    ],
    "type": "pkg"
  },
  {
    "declaration": {
      "binary": [
        "/usr/local/share/dotnet/dotnet"
      ],
      "target": "$HOMEBREW_PREFIX/bin/dotnet"
    },
    "phase": "install",
    "sources": [
      "/usr/local/share/dotnet/dotnet"
    ],
    "target": "$HOMEBREW_PREFIX/bin/dotnet",
    "type": "binary"
  },
  {
    "declaration": {
      "binary": [
        "/usr/local/share/dotnet/dnx"
      ],
      "target": "$HOMEBREW_PREFIX/bin/dnx"
    },
    "phase": "install",
    "sources": [
      "/usr/local/share/dotnet/dnx"
    ],
    "target": "$HOMEBREW_PREFIX/bin/dnx",
    "type": "binary"
  },
  {
    "declaration": {
      "zap": [
        {
          "delete": [
            "/etc/paths.d/dotnet",
            "/etc/paths.d/dotnet-cli-tools"
          ],
          "pkgutil": "com.microsoft.dotnet.*",
          "trash": [
            "~/.dotnet",
            "~/.nuget"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

Microsoft .NET SDK 是用于在 macOS 上构建、测试和发布 .NET 应用与库的命令行工具包。它包含 dotnet CLI、编译器、模板、MSBuild，以及与之匹配的 .NET 和 ASP.NET Core runtime。可用于控制台应用、Web 服务、类库、测试和受支持的平台工作负载，并配合兼容的编辑器或 IDE 使用；它本身不是独立 IDE，也不是 Java runtime。

### SDK 包含哪些内容以及可以构建什么

SDK 是 .NET 的构建时工具包。它包含 `dotnet` 命令、C# 和 F# 编译器、项目模板、MSBuild、NuGet 还原、测试运行器和发布工具。安装 SDK 时还会包含与其自身版本匹配的 .NET Runtime 和 ASP.NET Core Runtime，因此同一次安装既能构建也能运行应用。仅安装 runtime 可以运行应用，但不能构建应用。

典型用途包括控制台工具、Web API 和服务、类库、自动化测试以及受支持的平台工作负载。可以使用 `dotnet new` 创建新项目，使用 `dotnet restore` 还原依赖项，使用 `dotnet build` 运行构建，并使用 `dotnet publish` 生成发布输出。编辑时可以使用任何兼容的编辑器或 IDE；SDK 不会安装独立的 Mac 图形界面或 IDE。[Developer Workbench 合集](/collections/developer-workbench)列出了其他适用于 macOS 的命令行和开发工具。

### 在 Mac 上安装、设置 PATH 并创建可用项目

Microsoft 官方 PKG 是主要安装方式。Homebrew 用户可以使用 `brew install --cask dotnet-sdk` 安装同一个 cask；Homebrew 会在 Apple Silicon 上选择 Arm64 PKG，在 Intel 上选择 x64 PKG，并创建 `dotnet` 和 `dnx` 命令链接。Microsoft 还提供 `dotnet-install.sh` 和手动 tar.gz 方式，用于自动化或无需管理员权限的安装。如果安装后找不到 `dotnet`，请重新打开 Terminal。

使用 `dotnet --info`、`dotnet --version`、`dotnet --list-sdks` 和 `dotnet --list-runtimes` 检查安装。官方 PKG 通常会配置路径。对于脚本或手动安装，需要将安装目录添加到 PATH；Arm64 安装在 `/usr/local/share/dotnet` 下，x64 构建使用 `/usr/local/share/dotnet/x64/dotnet`。部分工具会读取 `DOTNET_ROOT`，当工具找不到 runtime 时应设置该变量。

要创建入门控制台项目，请运行 `dotnet new console -o HelloWorld`，使用 `cd HelloWorld` 进入该目录，然后运行 `dotnet run`。`global.json` 文件可以将项目固定到特定 SDK，并在安装了多个 SDK 时控制前滚行为；`dotnet --list-sdks` 会显示可用的 SDK。[.NET SDK 版本历史](/apps/dotnet-sdk/versions)记录了 cask 版本、匹配的 runtime 和发布日期。

### macOS 要求与架构

Microsoft 的 .NET 10 支持操作系统矩阵列出 macOS 15、26 和 27，支持 Arm64 和 x64。在 Apple Silicon 上，Arm64 版本原生运行，x64 版本可在 Rosetta 2 下运行。macOS 14 出现在不受支持表中，终止支持日期为 2026-09-14。Microsoft 的 macOS 安装页面仍列出一组较旧的版本；支持操作系统矩阵是更新时间更近的参考，因此在部署前请查阅该矩阵。

Homebrew cask 声明要求 macOS 12 或更高版本。该数字是 Homebrew 的安装最低要求，不是 Microsoft 的支持承诺。该 cask 还声明 arm64 和 x64 变体，并与 `dotnet-runtime`、`dotnet-runtime@preview` 和 `dotnet-sdk@preview` 冲突。用于移动端、桌面端或 Native AOT 的可选工作负载可能需要额外平台工具，例如 Xcode、工作负载包或签名凭据。Microsoft 并未针对每种工作负载发布统一的 RAM 或磁盘最低要求；项目、缓存和可选工作负载决定占用空间。其他语言 runtime 和 SDK 见[语言分类](/categories/languages)。

### 价格、许可与遥测

SDK 可免费下载和使用。`dotnet/sdk` 仓库使用 MIT 许可证，并包含附加组件声明。Homebrew cask 注明其软件包可能包含额外的闭源组件，因此这些部分适用安装程序声明或 EULA 中的条款；它在所有方面都并非全开源软件包。NuGet 包、商业 IDE、私有源、云托管和代码签名服务可能涉及单独的许可证或费用。

Microsoft 分发的 SDK 构建默认启用 CLI 遥测。设置 `DOTNET_CLI_TELEMETRY_OPTOUT=1`（或 `true`）可退出遥测；如果还想跳过安装程序的遥测事件，必须在运行安装程序之前设置该变量。

### 版本与支持状态

当前 cask 为 SDK 10.0.403，于 2026-10-25 发布，包含 .NET Runtime 10.0.14。SDK 与 runtime 的版本号不同：SDK 编号标识工具链，runtime 编号标识它所包含的 runtime。

| .NET | 支持类型 | 支持期 | 当前补丁（2026-11-04） | Homebrew cask 历史 |
|---|---|---|---|---|
| 10 | LTS | 2025-11-11 至 2028-11-14 | 10.0.14 / SDK 10.0.403 | 最新 10.0.403 |
| 9 | STS | 2024-11-12 至 2026-11-10 | 9.0.22 / SDK 9.0.320 | 止于 9.0.307（2025-11-19） |
| 8 | LTS | 2023-11-14 至 2026-11-10 | 8.0.33 / SDK 8.0.427 | 止于 8.0.404（2024-11-12） |
| 7 | STS | 已于 2024-05-14 结束（EOL） | 7.0.20 / SDK 7.0.410 | 止于 7.0.403（2023-10-24） |

cask 历史不是 Microsoft 的完整补丁列表。.NET 9 和 .NET 8 将于 2026-11-10 终止支持，因此请计划迁移到 .NET 10；.NET 7 已终止支持。每个版本的记录请使用[版本页面](/apps/dotnet-sdk/versions)，权威支持日期请查阅 Microsoft 发行说明。

### 替代方案与相邻 runtime

Temurin 17 和 Amazon Corretto 11 是 Java runtime，不是 .NET SDK 的直接替代品。需要 Java 工作负载时应选择它们，并将 `JAVA_HOME` 与 `DOTNET_ROOT` 分开设置；它们可以与 .NET 在同一台 Mac 上共存。它们的支持条款见 [Temurin 17](/apps/temurin@17) 和 [Corretto 11](/apps/corretto@11)。对于 .NET 本身，实际可行的替代方式包括并行安装不同 SDK 版本、使用官方 PKG 代替 cask，或在只需运行现有应用时仅安装 runtime。

### 常见问题

#### .NET SDK 免费吗？

是的。SDK 和 .NET runtime 均可免费下载和使用，`dotnet/sdk` 源代码采用 MIT 许可证。NuGet 包、商业 IDE、云服务和签名服务可能有各自的条款。Homebrew cask 可能包含额外的闭源组件；请查阅安装程序声明。

#### SDK 包含 runtime 吗？

包含。每个 SDK 版本都包含匹配的 .NET Runtime 和 ASP.NET Core Runtime，因此一次安装即可构建和运行应用。仅安装 runtime 可以运行应用，但不包含编译器、模板或 CLI 构建命令。

#### .NET 10 支持哪些 macOS 版本？

Microsoft 当前的支持操作系统矩阵列出 macOS 15、26 和 27，支持 Arm64 和 x64。macOS 14 自 2026-09-14 起不再受支持。Homebrew cask 的 macOS 12 最低要求是安装要求，不是 Microsoft 的支持声明。

#### 在 Apple Silicon 上应安装 Arm64 还是 x64 版本？

需要原生性能时使用 Arm64 版本。当工作负载或工具需要时，x64 版本可通过 Rosetta 2 运行。Homebrew 会自动选择匹配的软件包；同一 SDK 安装中应避免混用架构。

#### SDK 与 .NET Runtime 有什么区别？

SDK 用于构建、测试和发布 .NET 应用。runtime 用于运行这些应用。SDK 包含与其匹配的 runtime，而仅含 runtime 的安装无法构建或发布项目。

#### 如何更新 cask 或固定 SDK？

使用 `brew upgrade --cask dotnet-sdk` 更新，或安装更新的官方 PKG。要将项目保持在特定 SDK 上，请添加包含该 SDK 版本的 `global.json`；`dotnet --list-sdks` 会列出已安装的内容。更改 SDK 版本前请备份项目文件。

最后更新：2026-11-04。来源：Microsoft .NET 发行说明与支持政策、.NET 10 支持操作系统矩阵、Microsoft Learn macOS 安装指南以及 Homebrew cask 元数据。

### 官方参考资料

- [.NET 发行版与支持](https://github.com/dotnet/core/blob/main/releases.md)
- [.NET 10 发行说明](https://github.com/dotnet/core/blob/main/release-notes/10.0/README.md)
- [.NET 10.0.14 发行说明](https://github.com/dotnet/core/blob/main/release-notes/10.0/10.0.14/10.0.14.md)
- [.NET 10 支持操作系统矩阵](https://github.com/dotnet/core/blob/main/release-notes/10.0/supported-os.md)
- [在 macOS 上安装 .NET](https://learn.microsoft.com/en-us/dotnet/core/install/macos)
- [.NET CLI 遥测](https://learn.microsoft.com/en-us/dotnet/core/tools/telemetry)
- [dotnet/sdk 源代码](https://github.com/dotnet/sdk)
- [Homebrew cask dotnet-sdk](https://formulae.brew.sh/api/cask/dotnet-sdk.json)

## 系统要求

- macOS 12 起 · 应用版本: 11.0.100 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/d/dotnet-sdk.rb> · 核查于 2026-11-22
  - <https://builds.dotnet.microsoft.com/dotnet/Sdk/11.0.100/dotnet-sdk-11.0.100-osx-x64.pkg>
  - SHA-256: `7e8c004395d7e7944aeaf22527ddfad37692e801a694d94dda3932bf321be488`
- macOS 12 起 · 应用版本: 11.0.100 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/d/dotnet-sdk.rb> · 核查于 2026-11-22
  - <https://builds.dotnet.microsoft.com/dotnet/Sdk/11.0.100/dotnet-sdk-11.0.100-osx-arm64.pkg>
  - SHA-256: `96b96a7d7ec00b2397d575ffa7acfe685d7261fe2a2719d80131e5f8003deaf9`

## .NET SDK 的安全事实

这里只列可以核验的事实，并注明来源和日期，不是安全认证。要检查你下载的文件，可以用 OpenNavo 在本机扫描。

- <https://github.com/dotnet/sdk> · 是否开源: 是 — <https://github.com/dotnet/sdk> · 核查于 2026-11-13

## 卸载

- `brew uninstall --cask dotnet-sdk`

普通卸载会删除应用本身，设置和缓存会保留。

### 卸载时还会处理

- 安装包收据（pkgutil）: `com.microsoft.dotnet.*11.0*arm64` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/d/dotnet-sdk.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 安装包收据（pkgutil）: `com.microsoft.dotnet.sharedhost*arm64` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/d/dotnet-sdk.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 安装包收据（pkgutil）: `com.microsoft.netstandard.pack.targeting.*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/d/dotnet-sdk.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

### 深度清理（可选）

- `brew uninstall --zap --cask dotnet-sdk`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 安装包收据（pkgutil）: `com.microsoft.dotnet.*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/d/dotnet-sdk.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/.dotnet` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/d/dotnet-sdk.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/.nuget` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/d/dotnet-sdk.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `/etc/paths.d/dotnet` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/d/dotnet-sdk.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `/etc/paths.d/dotnet-cli-tools` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/d/dotnet-sdk.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 资料与来源

- <https://opennavo.com/zh/apps/dotnet-sdk>
- <https://opennavo.com/zh/apps/dotnet-sdk/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/d/dotnet-sdk.rb> · 核查于 2026-11-22
- <https://formulae.brew.sh/cask/dotnet-sdk>
- <https://github.com/dotnet/sdk> · 核查于 2026-11-13
