如何让 .NET 程序脱离系统安装的 .NET 运行时独立运行？

Question

从 .NET Core 3 开始，.NET 应用就支持独立部署自己的 .NET 运行时。 如何让 .NET 程序脱离系统安装的 .NET 运行时独立运行？

Answer 1

下午好🌅🌅🌅
本答案参考通义千问

要让 .NET 程序脱离系统安装的 .NET 运行时独立运行，你可以使用 .NET 的“自包含发布”（Self-Contained Deployment） 功能。这种方式会将 .NET 运行时和你的应用程序一起打包，使得程序可以在没有预先安装 .NET 的环境中运行。

---

✅ 一、关键概念说明

1. 自包含发布（Self-Contained Deployment）

• 该方式将 整个 .NET 运行时 和你的应用一起打包。
• 应用程序不依赖于系统中已安装的 .NET 运行时。
• 适用于需要在无 .NET 环境的机器上运行的应用程序。

2. 依赖框架发布（Framework-Dependent Deployment）

• 依赖于系统中已经安装的 .NET 运行时。
• 不包含 .NET 运行时，体积更小。
• 适用于开发或测试环境，或者你有权限确保目标系统已安装 .NET。

---

✅ 二、实现步骤（以 .NET Core / .NET 5+ 为例）

1. 使用 dotnet publish 命令进行自包含发布

dotnet publish -c Release -r <runtime-identifier> --self-contained true

参数说明：

• -c Release: 指定构建配置为 Release。
• -r <runtime-identifier>: 指定目标运行时（如 win-x64, linux-x64, osx-x64 等）。
• --self-contained true: 启用自包含发布。

示例：发布 Windows x64 平台的自包含应用

dotnet publish -c Release -r win-x64 --self-contained true

---

2. 发布后生成的文件结构

发布完成后，会在 bin/Release/<runtime-identifier>/publish/ 目录下生成以下内容：

• .exe 或 .dll 文件（应用程序）
• .runtimeconfig.json 文件（指定运行时配置）
• 一个名为 <appname>.runtimeconfig.dev.json 的开发配置文件（可删除）
• 一个 Microsoft.NETCore.App 文件夹（包含 .NET 运行时）

---

3. 部署到目标机器

将上述目录中的所有文件复制到目标机器上，并直接运行 .exe 文件即可，无需安装 .NET。

---

✅ 三、支持的运行时标识符（Runtime Identifiers）

| 平台 | 运行时标识符 | |------|--------------| | Windows x64 | win-x64 | | Windows x86 | win-x86 | | Linux x64 | linux-x64 | | macOS x64 | osx-x64 | | Linux ARM64 | linux-arm64 |

你可以通过以下命令查看支持的运行时：

dotnet --info

---

✅ 四、注意事项

1. 体积较大

• 自包含发布会显著增加应用程序的体积（因为包含了完整的 .NET 运行时）。

2. 不同平台需分别发布

• 每个平台都需要单独发布一次（例如：Windows 和 Linux 需要分别执行 dotnet publish）。

3. 依赖项管理

• 如果你使用了第三方库（如 NuGet 包），这些也会被包含在发布包中。

---

✅ 五、代码示例（修改后的项目文件）

如果你使用的是 .csproj 文件，可以添加如下配置来启用自包含发布：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <RuntimeIdentifier>win-x64</RuntimeIdentifier>
    <SelfContained>true</SelfContained>
  </PropertyGroup>
</Project>

然后运行：

dotnet publish

---

✅ 六、总结

如何让 .NET 程序脱离系统安装的 .NET 运行时独立运行？

答案是：使用 .NET 的“自包含发布”功能。

具体步骤如下：

1. 使用 dotnet publish 命令并设置 --self-contained true。
2. 指定目标运行时标识符（如 win-x64）。
3. 将发布目录中的所有文件部署到目标机器。
4. 直接运行 .exe 文件，无需安装 .NET。

---

✅ 七、附录：常用命令汇总

| 命令 | 说明 | |------|------| | dotnet publish -c Release -r win-x64 --self-contained true | 发布 Windows x64 平台的自包含应用 | | dotnet --info | 查看当前 .NET SDK 支持的运行时 | | dotnet new console | 创建一个新的控制台应用项目 |

---

如有其他问题，如跨平台部署、性能优化等，欢迎继续提问！