跳到正文

.NET SDK

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

Cask开发工具 3,252
主页
安装命令
brew install --cask dotnet-sdk
近 30 天安装
21,192
App榜第 17
近一年安装
12.8万
365 天累计
最新版本
11.0.100
下载大小
196MB
pkg
更新节奏
每天
近 30 天 9 个版本

介绍

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 合集列出了其他适用于 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 版本历史记录了 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 见语言分类。

价格、许可与遥测

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 已终止支持。每个版本的记录请使用版本页面,权威支持日期请查阅 Microsoft 发行说明。

替代方案与相邻 runtime

Temurin 17 和 Amazon Corretto 11 是 Java runtime,不是 .NET SDK 的直接替代品。需要 Java 工作负载时应选择它们,并将 JAVA_HOME 与 DOTNET_ROOT 分开设置;它们可以与 .NET 在同一台 Mac 上共存。它们的支持条款见 Temurin 17 和 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 元数据。

官方参考资料

基本信息

系统要求
macOS 12 起
芯片
Apple 芯片 · Intel
自动更新
否
仓库
开源 · MIT · 1 天前更新★3,252
开发者
Microsoft, .NET Foundation and contributors
Homebrew
可以安装,由 Homebrew 更新
其他名称
dotnet-sdk
主页
www.microsoft.com/net/core#macos
软件包标识符
dotnet-sdk

核查日期

如何在 Mac 上安装 .NET SDK

Homebrew 会运行安装包 dotnet-sdk-11.0.100-osx-arm64.pkg,需要输入管理员密码。

不用 Homebrew 安装

按芯片下载 Homebrew 使用的文件: 安装细节

卸载 .NET SDK 与可选的数据清理

卸载命令
brew uninstall --cask dotnet-sdk

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

深度清理(可选)
卸载命令
brew uninstall --zap --cask dotnet-sdk

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

关于 .NET SDK 的常见问题

.NET SDK 安全吗?

.NET SDK 收录在 Homebrew 官方软件库中,没有被停用。自 2026 年 9 月起,Homebrew 会停用没有通过 macOS Gatekeeper 检查的应用。安装时,Homebrew 会用 SHA-256 校验值核对来自 builds.dotnet.microsoft.com 的安装包。过去 30 天,它通过 Homebrew 安装了 21,192 次。

.NET SDK 是开源软件吗?

.NET SDK 的源代码公开在 GitHub 上(dotnet/sdk),使用 MIT 许可证。

怎样在 Mac 上彻底卸载 .NET SDK?

运行 brew uninstall --cask dotnet-sdk。它会清除 3 条安装记录。要连设置和缓存一起删除,运行 brew uninstall --zap --cask dotnet-sdk。--zap 还会删除 Homebrew 定义里列出的设置、缓存等文件,其中可能有其他应用共用的数据,删除后无法恢复;它也不保证没有任何残留。请先备份需要保留的数据;如要保留设置和缓存,请不要加 --zap。这会再删除 4 处文件和文件夹,包括 ~/.dotnet。

.NET SDK 支持 Apple 芯片(M1 及更新)的 Mac 吗?

支持。Homebrew 会为 Apple 芯片和 Intel 芯片的 Mac 分别下载不同的安装包。需要 macOS 12 或更高版本。

.NET SDK 的设置和数据保存在哪里?

数据保存在 ~/.dotnet和~/.nuget。这些位置来自 Homebrew 的清理清单。

.NET SDK 的最新版本是多少?

最新版本是 11.0.100,Homebrew 收录于 2026年11月11日。运行 brew upgrade --cask dotnet-sdk 即可更新。Homebrew 还提供 dotnet-sdk@preview,不能与它同时安装。

安装 .NET SDK 还会装上什么?

还会装上 2 个命令行工具:dotnet和dnx。它通过 .pkg 安装器安装,安装时需要输入管理员密码。它不能和 dotnet-runtime和dotnet-runtime@preview 同时安装。

相似应用

  • Postman用于 API 开发和测试的桌面应用,支持请求、集合、脚本测试和团队工作区;云功能受账户和套餐限制。
  • Flutter SDK开源 Dart 工具包,用于构建 Android、iOS、Web 和桌面应用,提供可复用小组件、热重载和集成开发工具。
  • GitHub Copilot CLI用于理解、规划、编辑和调试项目的终端 AI 编码助手,支持 GitHub 集成、自定义代理和 MCP 工具。
  • Zed适用于 macOS、Linux 和 Windows 的快速原生代码编辑器,具备语言工具、Git、终端、协作、远程开发及可选 AI 代理。
查看更多