Visual Studio 可直接生成 C# 项目的 .exe 文件，需选控制台/WinForms/WPF 项目类型，发布时配置“单文件”和“自包含”选项，并确保目标机安装对应 .NET Desktop Runtime。
用 Visual Studio 直接生成 .exe 文件
Visual Studio 默认就支持将 C# 项目编译为独立的 .exe 文件，关键在于选对项目类型和发布配置。控制台应用、Windows 窗体应用、WPF 应用都能生成 .exe，但 ASP.NET Core 项目不行（它生成的是 Web 服务，不是桌面可执行文件）。
操作路径：右键项目 → 发布 → 选择“文件夹”目标 → 发布后，在输出目录里找到 yourapp.exe（注意：它依赖 .NET 运行时，不是传统“单文件无依赖”）。
- 若项目是
net6.0或更高版本，可在发布设置中勾选 “产生单文件” 和 “启用 ReadyToRun 编译” 来减少依赖体积 - 目标运行环境必须安装对应版本的
.NET Desktop Runtime（例如dotnet-runtime-6.0.33-win-x64.exe），否则双击报错：“未能加载文件或程序集” - 发布前确认
Output Type是Windows Application或Console Application（在项目属性 → 应用程序页查看）
命令行用 dotnet publish 打包
适合 CI/CD 或需要精细控制参数的场景。核心命令是 dotnet publish，它比 dotnet build 多一步打包逻辑，会把依赖、运行时、资源全整合进输出目录。
常见组合：
dotnet publish -c Release -r win-x64 --self-contained false -o ./publish
说明：-r win-x64 指定运行时标识符（RID），--self-contained false 表示不打包 .NET 运行时（需用户本机已安装）；若设为 true，则生成真正“带运行时”的大体积 .exe（约 80–120 MB）。
-
--self-contained true+-r win-x64→ 输出含运行时的独立.exe，可直接在没装 .NET 的 Win10+ 机器上运行 -
--self-contained false+-r win-x64→ 输出轻量.exe，但目标机必须装对应版本的Desktop Runtime - 不要混用
-r和--self-contained false以外的 RID（如win-arm64）却不指定平台，否则可能生成无法启动的文件
生成真正单文件 .exe（不含外部 DLL）
默认发布的“单文件”其实是压缩包解压到临时目录再运行，并非传统意义上 Windows 原生单文件。要彻底合并成一个不可分割的 .exe，需额外步骤：
- 使用
dotnet publish -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true（.NET 5+ 支持） - 配合
-r win-x64和--self-contained true，最终输出一个约 100MB 左右的纯.exe，无任何附属文件 - 注意：某些反病毒软件会误报这类单文件为可疑程序（因它包含解压逻辑），内网部署时可能被拦截
- 调试困难：符号文件（
.pdb）不会自动嵌入，需手动加-p:DebugType=embedded
常见错误与绕过方式
打包后双击无反应、黑窗一闪而逝、或弹出“缺少 dll”提示，基本都源于依赖路径或运行时缺失。
- 错误信息：
System.IO.FileNotFoundException: Could not load file or assembly 'System.Drawing.Common→ 缺少System.Drawing.CommonNuGet 包，或未在.csproj中声明<frameworkreference include="Microsoft.WindowsDesktop.App"></frameworkreference>（WPF/WinForms 项目必需） - 发布后图标不显示 → 图标资源未设为
Embedded Resource，或Application Icon属性未在项目属性中指定.ico文件 - 用
dotnet publish打包却找不到.exe→ 检查是否用了--no-self-contained却没装运行时；或者输出路径被重定向到了bin/Release/net8.0/而非你指定的-o目录
真正麻烦的不是怎么生成 .exe，而是搞清它背后依赖哪套运行时、目标机器有没有、以及要不要为兼容旧系统降级 TargetFramework。很多“打包失败”本质是环境假设错了。
