关键在发布而非编译：需用dotnet publish指定-r win-x64、--self-contained true、/p:PublishSingleFile=true及/p:IncludeNativeLibrariesForSelfExtract=true，并设<OutputType>WinExe</OutputType>，才能生成真正双击即运行、无依赖的单文件EXE。
直接生成可运行的 .exe 文件不难，但“能双击就跑”和“在别人电脑上也能跑”，是两回事。关键不在编译，而在发布时对运行时、平台、依赖的显式声明。
dotnet publish 是打包的核心命令，不是 dotnet build
dotnet build 只生成中间产物（.dll），不能直接运行；dotnet publish 才真正整合运行时、资源、依赖，输出可部署目录或单文件。
常见错误是只用 build，然后把 bin\Release\net6.0\MyApp.dll 拷给别人——这根本不是可执行文件，双击没反应，命令行运行还得敲 dotnet MyApp.dll，用户根本不会。
- 必须指定
-r win-x64（或win-arm64）：否则默认为“便携式 RID”，发布的.exe实际是 stub，依赖本机安装对应桌面运行时 -
--self-contained true和--self-contained false行为完全不同：
—false：输出轻量.exe+ 一堆.dll，目标机需装dotnet-runtime-6.0.xxx-win-x64
—true：输出含完整运行时的独立包（约 100MB），无外部依赖，适合离线分发 - 别漏掉
-c Release：Debug 模式发布的程序带调试符号、未优化，体积大且可能被杀软拦截
要真·单文件 .exe，得组合四个参数
VS 界面里勾选“产生单文件”只是第一步。默认发布的“单文件”其实是压缩包，首次运行会解压到 %TEMP%\.net\ 下再加载——它仍会产生临时文件，且反病毒软件常报“可疑行为”。要彻底合并成一个原生 .exe（无任何附属文件、不解压到磁盘），必须同时满足：
/p:PublishSingleFile=true/p:IncludeNativeLibrariesForSelfExtract=true--self-contained true-
-r win-x64（RID 必须匹配，不能省）
完整命令示例：dotnet publish -c Release -r win-x64 --self-contained true /p:PublishSingleFile=true /p:IncludeNativeLibrariesForSelfExtract=true -o ./publish
输出目录里只有一个 MyApp.exe，大小约 90–120 MB，双击即运行，无残留。
WinForms/WPF 项目必须设 OutputType=WinExe，否则黑窗一闪而过
控制台项目默认是 Exe，双击会弹 CMD 窗口；WinForms 或 WPF 项目若没改类型，即使代码里用了 Application.Run()，发布后双击也会闪退——因为 Windows 把它当控制台程序启动，主线程结束就退出。
- 检查
.csproj文件里是否有：<OutputType>WinExe</OutputType> - VS 中右键项目 → 属性 → 应用程序 → 输出类型，必须选“Windows 应用程序”
- 如果用
dotnet new winforms创建，默认已设好；但迁移旧项目或手动改项目 SDK 时容易漏掉
发布后运行报“未能加载文件或程序集”，90% 是运行时版本或位数错配
典型错误信息：System.IO.FileNotFoundException: Could not load file or assembly 'System.Runtime, Version=6.0.0.0...' 或直接弹窗“缺少 .NET Runtime”。这不是你代码的问题，而是环境没对齐。
- 确认目标机安装的是 Desktop Runtime（不是 Server Hosting Bundle 或 ASP.NET Core Runtime）
- 版本号必须严格一致：项目用
<TargetFramework>net6.0</TargetFramework>，就得装dotnet-desktopruntime-6.0.33-win-x64.exe（2026 年当前最新补丁版） - CPU 架构不能混：x64 项目发布后，不能在 x86 系统运行；ARM64 项目也不能在 x64 机器上跑（哪怕系统是 Win11 ARM64 模拟 x64）
- 用
dotnet --list-runtimes在目标机上查已装运行时，比看“控制面板→程序”更准
最稳妥的路径，就是用 --self-contained true 发布，绕开所有运行时安装问题。但要注意：它会让最终 EXE 失去热更新能力，每次更新都得全量替换。
