如何在 Linux 上从二进制压缩包安装 .NET 10 并配置 DOTNET

如何在 Linux 上从二进制压缩包安装 .NET 10 并配置 DOTNET_ROOT 与 PATH 环境变量

【免费下载链接】core.NET news, announcements, release notes, and more!项目地址: https://gitcode.com/GitHub_Trending/core82/core

如果你需要在 Linux 上以非系统包管理器的方式安装 .NET 10——例如只给单个用户安装 .NET，或只做临时安装——官方文档给出的方式就是使用二进制压缩包（.tar.gz）。本文按 Linux 安装说明中“Installing from a binary archive”一节的操作流程，完成 .NET SDK 10 的下载、解压、配置DOTNET_ROOT与PATH环境变量，并用dotnet --version验证安装结果。

先确认要安装的分发版

.NET 10 Linux 安装说明列出三种 Linux 分发版：

.NET SDK：包含构建与测试应用所需的工具，并包含下列运行时分发版；
.NET Runtime：包含 .NET 运行时与库，可运行控制台应用；
ASP.NET Core Runtime：包含 .NET 与 ASP.NET Core 运行时，可运行控制台和 Web 应用。

文档建议：开发、构建应用时安装 .NET SDK；如果只运行应用，安装其中一种运行时包（如 ASP.NET Core）。后文以 .NET SDK 为例。

准备：按发行版安装系统依赖

运行 .NET 需要系统依赖包清单中列出的组件：C Library、GCC 低级运行时库（libgcc）、CA 证书、OpenSSL、C++ 库、ICU、tz 数据库、Kerberos。各发行版的安装命令在该文档中按 Alpine、Arch、Azure Linux、CentOS Stream、Debian、Fedora、FreeBSD、openSUSE、RHEL、SLES、Ubuntu 分别列出，命令都需要sudo权限，会实际安装系统包。

以 Ubuntu 24.04 为例：

sudo apt-get update && \ sudo apt-get install -y \ ca-certificates \ libc6 \ libgcc-s1 \ libgssapi-krb5-2 \ libicu74 \ libssl3t64 \ libstdc++6 \ tzdata

两点来自文档的补充说明：

如果启用了 globalization invariant 模式，则不需要安装 ICU；
如果应用依赖https端点，需要安装ca-certificates。

主流程：下载、解压、配置环境变量

以下命令来自 Linux 安装说明中演示“从命令行下载、解压、配置并运行 .NET SDK”的完整工作流。示例下载的是 SDK 10.0.101 的 linux-x64 压缩包；如果你想安装更新的 SDK（例如 10.0.400），可从 .NET 10 发布说明中对应版本页面（如 10.0.11）获取对应的dotnet-sdk-*-linux-x64.tar.gz下载链接，URL 模式相同。

~# curl -Lo dotnet.tar.gz https://builds.dotnet.microsoft.com/dotnet/Sdk/10.0.101/dotnet-sdk-10.0.101-linux-x64.tar.gz ~# mkdir dotnet ~# tar -C dotnet -xf dotnet.tar.gz ~# rm dotnet.tar.gz ~# export DOTNET_ROOT=~/dotnet ~# export PATH=$PATH:~/dotnet ~# dotnet --version 10.0.101

各步骤说明：

curl -Lo dotnet.tar.gz <URL>：把 SDK 压缩包下载到当前目录并命名为dotnet.tar.gz。若你从发布说明页选择了其他版本，替换为对应 URL 即可。每个发布说明页面（如 10.0.0）还附有 Checksums 链接，可用来校验压缩包完整性。
mkdir dotnet：创建安装目录，示例放在用户主目录下；换成其他目录时，后面DOTNET_ROOT的值要相应替换。
tar -C dotnet -xf dotnet.tar.gz：把压缩包内容解压到dotnet目录，不产生嵌套层级。
rm dotnet.tar.gz：删除已解压的压缩包文件。副作用仅限删除这一个本地文件，安装完成后不再需要它。
export DOTNET_ROOT=~/dotnet与export PATH=$PATH:~/dotnet：为当前 shell 会话配置环境变量，含义见下一节。

DOTNET_ROOT 与 PATH 各自的作用

Linux 安装说明对这两个变量的说明如下：

DOTNET_ROOT：当应用不是安装在默认位置、而是通过可执行文件（如myapp.exe）启动时，可执行文件会查找这个环境变量来定位运行时，因此它是必需的；
PATH：只有更新了这个变量，才能在任意位置直接用dotnet命令，而不必使用绝对路径；
文档同时指出，“设置这两个环境变量是可选的”——即如果你的使用方式不依赖上述两种场景（比如始终用绝对路径调用），可以不设。

文档还说明，如果希望永久生效，可以把 .NET 安装位置永久加入你的 path；export只对当前 shell 会话有效，重开会话后需要重新执行或在 shell 配置中自行追加。

验证安装结果

主路径的验证就是上面工作流的最后一条命令，安装 10.0.101 后文档示例输出为：

~# dotnet --version 10.0.101

如果安装的是其他版本，输出应为对应的 SDK 版本号，例如按 10.0.11 发布说明安装 SDK 10.0.400 后：

$ dotnet --version 10.0.400

还可以用dotnet --info查看机器上实际安装的 SDK 与运行时，通用安装说明给出的文档示例输出（版本为 preview，仅作输出格式参考）：

$ dotnet --info .NET SDK (reflecting any global.json): Version: 10.0.100-preview.1.25120.13 Commit: 0a5360315a Runtime Environment: OS Name: Mac OS X ... .NET SDKs installed: 10.0.100-preview.1.25120.13 [/usr/local/share/dotnet/x64/sdk] .NET runtimes installed: Microsoft.AspNetCore.App 10.0.100-preview.1.25120.13 [...] Microsoft.NETCore.App 10.0.100-preview.1.25120.13 [...]

边界与相关限制

二进制压缩包是单用户安装的必需方式，也是临时安装的推荐方式（Linux 安装说明）；面向全机器的安装请使用 Snap 或包管理器方式。
依赖包命令必须按实际发行版选择：依赖清单与受支持 OS 列表中列出的发行版版本（如 Ubuntu 25.10/24.04/22.04、Debian 13/12、RHEL 10/9/8 等）之外，没有经过 .NET 10 的支持确认。
只运行 Web 应用时可下载 ASP.NET Core Runtime 的.tar.gz（各版本发布说明页提供对应链接），解压与环境变量配置方式与 SDK 完全相同。
文档同时提供 Linux（Alpine、Debian、Ubuntu）的容器镜像作为替代路径；如果走容器方式，本文的解压与环境变量步骤不适用。

完成上述步骤后，dotnet --version能输出你安装的 SDK 版本号，就说明二进制压缩包安装与环境变量配置已经生效，可以直接在 Linux 上构建或运行 .NET 10 应用。

【免费下载链接】core.NET news, announcements, release notes, and more!项目地址: https://gitcode.com/GitHub_Trending/core82/core

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考