如何在自制.MSI安装程序运行时自动安装.Net依赖环境

针对离线环境下控制台应用安装时自动处理.Net依赖的需求，有两类成熟实现方案，按需选择即可：

方案1：独立模式发布应用（无需额外安装.Net运行时） #

这是成本最低、兼容性最好的方案，不需要在MSI里嵌套额外的安装逻辑：

• 右键控制台项目选择「发布」，发布目标选择「文件夹」
• 配置发布参数：部署模式选独立，目标运行时选择客户端设备对应的系统架构（如win-x64/win-x86，不要选可移植版本）
• 可选配置：勾选「生成单个文件」减少输出文件数量，勾选「裁剪未使用的代码」压缩包体积（裁剪后必须全流程测试功能，避免误删依赖导致运行异常）
• 执行发布，输出目录中会包含你的程序exe和所有依赖的.Net运行时文件，直接把整个发布目录的文件打包进MSI即可。客户端安装后直接运行exe，不需要全局安装.Net环境，完全离线可用。

注意：独立部署模式下安装包体积会增加50M-200M不等，属于正常情况，运行时文件仅存放在你的应用目录下，不会和系统中其他版本的.Net产生冲突。

方案2：MSI嵌套离线运行时安装包，安装流程自动静默部署 #

如果需要在客户端全局安装对应.Net版本（比如多个程序共用同一个运行时），可以用这个方案：

• 第一步：下载对应版本的.Net离线安装包
  • 若目标是.Net Framework（4.0/4.5/4.7.2/4.8等版本），下载对应版本的可再发行离线安装包，不要下载web引导版
  • 若目标是.Net Core/.NET 5+（.NET 6/.NET 8等版本），下载对应版本的控制台运行时/桌面运行时离线exe安装包，避开web安装版本
• 第二步：将离线安装包嵌入MSI工程
  • 用Visual Studio Installer Projects打包的话，在MSI项目的文件系统视图中新建临时存储文件夹（命名为Prerequisites即可），把下载好的离线运行时安装包放入该文件夹，设置为安装时释放到系统临时目录
  • 用WiX、Advanced Installer等第三方打包工具的话，直接将离线安装包添加为安装临时资源，配置安装阶段的释放路径即可
• 第三步：配置安装检测与自动执行逻辑
  • 首先配置MSI启动检测规则：判断客户端是否已安装对应版本的.Net，已安装则直接跳过运行时安装步骤。检测规则可通过注册表（.Net Framework）、系统目录文件校验（.NET 5+检查%ProgramFiles%\dotnet\shared下对应版本的运行时文件夹是否存在）实现
  • 若检测到未安装对应环境，配置MSI自定义安装动作，在安装初始化阶段以静默参数启动释放到临时目录的运行时安装包：
    • .Net Framework离线包静默安装参数：/q /norestart
    • .NET 5+运行时离线包静默安装参数：/install /quiet /norestart
  • 自定义动作需设置为「等待执行完成」，等运行时安装结束后再继续主程序的安装流程，避免运行时未部署完成就启动主程序报错
• 第四步：配置重启逻辑，若运行时安装触发重启要求，可设置为延后到主程序安装完成后提示用户重启，避免打断安装流程。

常见问题避坑 #

• 绝对不要嵌入web版的.Net安装引导程序，这类程序启动后必须联网下载组件，离线环境下会直接安装失败
• 注意.Net版本和客户端系统的兼容性，比如.NET 8不支持Windows 7，老系统最高适配到.NET 6
• 运行时安装需要管理员权限，记得给MSI配置安装时申请管理员权限，否则会因为权限不足安装失败
• 独立部署模式下不要随意删除发布目录内的dll文件，其中包含大量运行时核心依赖，删除后会导致程序无法启动。

内容的提问来源于stack exchange，提问作者C47_C0D3R