安装 .NET SDK 只需 3 种路径：一条命令装好 .NET 10 LTS 的完整指南

安装 .NET SDK 只需 3 种路径一条命令装好 .NET 10 LTS 的完整指南【免费下载链接】core.NET news, announcements, release notes, and more!项目地址: https://gitcode.com/GitHub_Trending/core82/core新环境装 .NET SDK最容易卡在装哪个包、用什么方式、依赖缺什么这三件事上。.NET 10 是 LTS 版本支持到 2028 年 11 月装好之后基本一劳永逸。下面按你的场景该走哪条路来讲最快一条命令最稳一次配环境。先选路哪种安装方式适合你安装方式就 4 类按你的角色对号入座开发者日常写代码→ 装 .NET SDK构建工具 运行时SDK 里已包含运行时Windows 桌面用户→winget最快macOS 桌面用户→ Homebrew 或官方 PKG 安装包Linux 服务器 / 生产机→ 系统包管理器apt / dnf / zypper / apk只有普通用户权限、临时试用、不想动系统目录→ 二进制归档文件解压即用CI/CD 管道→ 官方dotnet-install.sh/dotnet-install.ps1安装脚本可精确指定通道和安装目录你的场景推荐方式核心特点Windows 开发机winget包管理器一条命令自动配 PATHLinux / macOS 开发机系统包管理器或 PKG自动处理依赖方便统一升级生产服务器系统包管理器依赖自动解决便于批量运维临时环境 / 无管理员权限二进制归档tar.gz / zip免权限、免系统改动CI/CD 自动化dotnet-install 脚本可定制通道、版本与安装目录 官方建议开发构建装 SDK如果某台机器只跑应用装对应运行时包即可如 ASP.NET Core Runtime体积更小。下一步确认系统版本在支持清单里再去装。装之前确认系统在这张清单上不用逐平台翻文档看版本对不对就行完整清单见 10.0 支持的操作系统WindowsWindows 10 / 11各 24H2、23H2 等版本及 Windows Server 2016 及以上LinuxUbuntu 22.04 / 24.04 / 25.10、Debian 12 / 13、RHEL 8 / 9 / 10、Fedora 42–44、Alpine 3.21–3.23、CentOS Stream 9 / 10、openSUSE Leap 16.0macOS14 / 15 / 26x64 与 Apple Silicon 均可Linux 二进制包额外依赖OpenSSL、ICU、CA 证书、glibc、tzdata 等系统库包管理器安装时会自动带上手动解压归档则需自行确认清单见 Linux 依赖包版本不支持的话升级系统比降级 .NET 更划算。下一步按下面的路径开始安装。最快路径一条命令装好 .NET 10Windowswinget 直接装Windows 10 及以上自带 winget打开 PowerShell 执行winget install dotnet-sdk-10 # 装 .NET 10 SDK开发用 winget install dotnet-runtime-10 # 只装运行时仅运行应用装完新开一个终端窗口旧窗口里 PATH 还没生效就可以用了。以后升级运行winget upgrade即可。macOSHomebrew 或 PKG 二选一brew install dotnet-sdk # 装 .NET 10 SDKHomebrew 会自动处理依赖不喜欢 Homebrew 的话去 10.0 下载说明 拿 PKG 安装包双击按向导点继续到结束全程图形界面。 这两条路装完基本零配置包管理器会把安装目录加进 PATH依赖也齐了。下一步验证一下装没装成功。标准路径二进制归档文件解压即用适合无管理员权限、只想装给自己用、或做临时测试的场景Linux / macOS / Windows 通用。以 Linux x64 为例macOS 把文件名里的linux-x64换成osx-x64即可# 下载 .NET SDK 10.0.400 二进制包当前稳定版见 release-notes/10.0/releases.json curl -Lo dotnet.tar.gz https://builds.dotnet.microsoft.com/dotnet/Sdk/10.0.400/dotnet-sdk-10.0.400-linux-x64.tar.gz # 建目录并解压 mkdir -p ~/dotnet tar -C ~/dotnet -xf dotnet.tar.gz # 配置环境变量DOTNET_ROOT 供 apphost 可执行文件myapp.exe定位运行时 export DOTNET_ROOT$HOME/dotnet # 加入 PATH让 dotnet 命令可直接调用 export PATH$PATH:$HOME/dotnet # 顺手删掉压缩包省空间 rm dotnet.tar.gzWindows 下逻辑完全一样只是把tar.gz换成 zip 包export换成set。⚠️ 上面的export只对当前终端会话有效。想永久生效把这两行追加到~/.bashrc或~/.zshrc。下一步需要长期部署到服务器走包管理器更省心。生产路径包管理器系统级安装Ubuntu / Debian 服务器上推荐走 Microsoft 软件源后续apt upgrade就能跟着打补丁# 添加 Microsoft 包源以 Ubuntu 22.04 为例 wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb sudo dpkg -i packages-microsoft-prod.deb # 刷新索引并安装 .NET 10 SDK sudo apt-get update sudo apt-get install -y dotnet-sdk-10.0其他发行版各有对应写法细节见 Linux 安装说明 和 os-packages 清单。IIS 托管多装一个 Hosting Bundle要在 Windows Server IIS 上跑 ASP.NET Core光装运行时还不够需要ASP.NET Core Hosting Bundle——它在运行时之外附带了 IIS 模块支持进程内和进程外两种托管模式。详见 Windows 安装说明。下一步装完统一验证一遍。验证安装一条命令看全貌dotnet --info输出里只盯这三段就够了.NET SDK: Version: 10.0.400 # ← SDK 版本对得上 Runtime Environment: OS Name: Windows # ← 系统信息 .NET runtimes installed: Microsoft.NETCore.App 10.0.x看到 SDK 版本号 已装运行时列表就齐活了。如果只想确认版本dotnet --version。下一步想搭第一个项目直接dotnet new console然后dotnet run。高频排错3 个最常踩的坑1. Linux 上运行报缺库错误典型报错是Fatal error. The library libicu... was not found。原因是系统库没装全ICU、OpenSSL、CA 证书等按发行版执行对应安装命令即可各发行版的完整命令都列在 dotnet-dependencies.md。2. 新开终端找不到 dotnet 命令归档安装的环境变量只写在了当前会话里。把DOTNET_ROOT和PATH两行追加到 shell 配置文件~/.bashrc/~/.zshrc或者重开终端后重新export。3. 项目要锁 SDK 版本多个版本共存时在项目目录放一个global.json{ sdk: { version: 10.0.400 } }再用dotnet --list-sdks核对机器上到底装了哪些版本。其余已知问题如 macOS 调试器崩溃、Debian 13 安装警告等可查 10.0 已知问题。下一步装完就能开干环境就绪后建议dotnet new console建一个控制台项目dotnet run跑起来确认工具链完整需要跨端开发再装工作负载如dotnet workload install maui持续关注版本更新.NET 10 是 LTS安全补丁会一直发到 2028 年 11 月。延伸阅读仓库内文档各平台安装说明install.md、install-linux.md、install-macos.md、install-windows.md支持的系统清单supported-os.mdLinux 依赖包dotnet-dependencies.md发行版与版本信息releases.json、known-issues.md上手指南get-started.md【免费下载链接】core.NET news, announcements, release notes, and more!项目地址: https://gitcode.com/GitHub_Trending/core82/core创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考