.NET Core 多平台安装全攻略Windows、Linux、macOS 一次装明白【免费下载链接】core.NET news, announcements, release notes, and more!项目地址: https://gitcode.com/GitHub_Trending/core82/core想在 Windows、Linux 或 macOS 上搭好开发环境又不知道该下哪个包.NET Core 是一套跨平台的开源框架用来构建和运行控制台应用、Web 应用和桌面应用。围绕 .NET Core 安装这件事常见的卡点其实就三个装 SDK 还是装 Runtime不同系统到底用哪种方式最省事装完怎么确认没问题。这篇指南以 .NET 10LTS 版本从 2025 年 11 月起提供三年支持为例按你的实际场景把安装流程讲清楚照着敲命令就能跑通。先搞清楚要装什么SDK 还是 Runtime很多人装完发现跑不了 Web 项目或没有编译器根源就是选错了分发包。两者区别很简单分发包里面有什么什么时候选它.NET SDK编译器、构建/测试工具并自带下面这些运行时要写代码、构建、调试选它准没错.NET Runtime仅运行时和基础类库只跑控制台程序ASP.NET Core Runtime.NET 运行时 ASP.NET Core 运行时只跑 Web 应用.NET Desktop Runtime仅 Windows.NET 运行时 WinForms/WPF 桌面库只跑 Windows 桌面程序ASP.NET Core Hosting Bundle仅 WindowsASP.NET Core 运行时 IIS 模块用 IIS 托管 ASP.NET Core 应用一句话决策开发机装 SDK纯运行的服务器只装对应的 Runtime 包更轻。对号入座你的场景该用哪种装法你的场景平台推荐安装方式开发者本机快速上手Windowswinget 命令行 或 MSI 安装程序开发者本机快速上手macOSPKG 安装程序服务器生产部署Linux发行版包管理器apt 等服务器生产部署Windows ServerMSIIIS 托管则装 Hosting Bundle免管理员权限 / 临时用 / 多版本共存全部平台二进制归档tar.gz / zip解压即用场景一开发者本机快速上手Windowswinget 一条命令装好Windows 10 以上自带 wingetWindows 包管理器相当于 Linux 上的 apt打开 PowerShell 直接敲# 安装 .NET 10 SDK含编译器、构建工具和全部运行时 winget install dotnet-sdk-10只打算运行程序、不写代码就装运行时# 安装 .NET 10 运行时 winget install dotnet-runtime-10以后有更新winget upgrade一条命令续上。WindowsMSI 安装程序走图形界面不想碰命令行也行从官方下载页拿到 MSI 安装包双击运行点Install向导会一路装完 SDK。macOSPKG 双击就装好从 macOS 安装页下载 PKG 安装包双击打开点Continue按提示走完即可。场景二服务器与生产环境部署Linux包管理器安装以 Ubuntu 为例包管理器装法的好处是依赖自动处理、后续apt升级省心。Ubuntu 22.04 上三步走# 下载微软仓库的配置文件.deb 包让 apt 认识 Microsoft 软件源 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其他发行版Debian、Fedora、CentOS Stream、Alpine、RHEL 等的对应命令见官方安装文档install-linux.md。服务器只跑 Web 应用的话把包名换成对应的 ASP.NET Core 运行时即可不用带编译器。Windows ServerIIS 托管 ASP.NET Core要在 IIS 里跑 ASP.NET Core别只装运行时——下载并安装 ASP.NET Core Hosting Bundle 的 MSI。它把 .NET 运行时和 IIS 模块打包在一起进程内、进程外两种托管模式都能用。场景三免管理员权限的轻量部署想在自己家目录里解压即用、给单个用户装、或者同一台机器上并存多个 .NET 版本用二进制归档。原理都一样下载压缩包 → 解压到任意目录 → 设两个环境变量。其中DOTNET_ROOT告诉可执行程序如myapp.exe运行时在哪儿PATH让你能直接敲dotnet而不用写绝对路径两者设不设都合法设了更顺手。Linux# 下载 .NET SDK 压缩包 curl -Lo dotnet.tar.gz https://builds.dotnet.microsoft.com/dotnet/Sdk/10.0.100-rc.1.25451.107/dotnet-sdk-10.0.100-rc.1.25451.107-linux-x64.tar.gz # 建目录并解压 mkdir -p $HOME/dotnet tar zxf dotnet.tar.gz -C $HOME/dotnet # 配置环境变量 export DOTNET_ROOT$HOME/dotnet export PATH$PATH:$HOME/dotnet # 验证安装 dotnet --version想让配置长期生效把两行export写进~/.bashrc或~/.zshrc。macOS同一套命令只换下载链接# 下载并解压 .NET SDK curl -Lo dotnet.tar.gz https://builds.dotnet.microsoft.com/dotnet/Sdk/10.0.100-rc.1.25451.107/dotnet-sdk-10.0.100-rc.1.25451.107-osx-x64.tar.gz mkdir -p $HOME/dotnet tar zxf dotnet.tar.gz -C $HOME/dotnet # 配置环境变量 export DOTNET_ROOT$HOME/dotnet export PATH$PATH:$HOME/dotnet # 验证安装 dotnet --versionWindows:: 下载 .NET SDK 归档 curl -Lo dotnet.zip https://builds.dotnet.microsoft.com/dotnet/Sdk/10.0.101/dotnet-sdk-10.0.101-win-x64.exe :: 解压并清理 tar -C dotnet -xf dotnet.zip del dotnet.zip :: 设置环境变量当前会话生效永久生效请用系统属性修改 set DOTNET_ROOTC:\dotnet set PATH%PATH%;C:\dotnet :: 验证安装 dotnet --version装好了怎么确认新开一个终端敲dotnet --info能看到 SDK 版本号和运行时列表就说明装成功了关键几行长这样.NET SDK (reflecting any global.json): Version: 10.0.100-preview.1.25120.13 Commit: 0a5360315a Host: Version: 10.0.100-preview.1.25120.13 Architecture: x64顺手再跑两个命令交叉核对# 只关心版本号 dotnet --version # 看机器上装了哪些 SDK多版本共存时有用 dotnet --list-sdks装不上先查这几个高频问题现象提示找到的 SDK 版本和项目要求不符原因机器上装了多个 .NET 版本项目又指定了特定版本。解决在项目根目录放global.json钉住版本{ sdk: { version: 10.0.100 } }再用dotnet --list-sdks确认本地确实有对应版本没有就补装。现象Linux 上运行报缺库、启动失败原因.NET 依赖一组系统包——C 库、libgcc、ca-certificates、OpenSSLlibssl、C 库libstdc、ICU、tzdata、Kerberos精简系统往往缺其中几个。解决按发行版补装对应依赖各发行版Alpine、Ubuntu、Debian、Fedora 等的安装命令都列在 dotnet-dependencies.md 里。特别提醒应用用到https时ca-certificates必装。现象装完了终端却提示找不到dotnet命令原因走的是二进制归档安装PATH/DOTNET_ROOT没设或没重新打开终端。解决补设两个环境变量然后重开终端再验证。现象系统版本太老装不上或不被支持原因操作系统不在支持清单里如 Windows 要求 10/11 或 Server 2016 及以上macOS 要求 12 及以上Linux 各发行版有具体版本下限。解决对照 supported-os.md 查你的系统是否在清单内。下一步跑起你的第一个项目环境就绪了建个控制台项目试试手感# 在当前目录新建控制台项目 dotnet new console # 运行它 dotnet runWeb 应用则是dotnet new web后dotnet run。装完第一个程序你就算正式上路了。延伸阅读官方安装总览install.md分平台安装文档install-windows.md、install-linux.md、install-macos.md支持的操作系统清单supported-os.md.NET 10 发行说明与补丁版本README.mdLinux 系统依赖包详情dotnet-dependencies.md【免费下载链接】core.NET news, announcements, release notes, and more!项目地址: https://gitcode.com/GitHub_Trending/core82/core创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考