启用 PublishSingleFile=true 后仍生成多文件，因默认未禁用解压行为；需添加 --self-contained true、-r win-x64（或对应 RID）、-p:IncludeNativeLibrariesForSelfExtract=false 才能生成真正单个可执行文件。
dotnet publish -p:PublishSingleFile=true 为什么生成的还是多个文件
默认情况下，PublishSingleFile 只是启用单文件打包逻辑，但不会自动开启“完全隔离”模式——它仍可能把运行时、PDB 或某些平台特定资源解压到临时目录运行。真正打出「一个 .exe 就能双击运行」的包，必须显式关闭提取行为。
- 必须加
-p:IncludeNativeLibrariesForSelfExtract=false，否则 Windows 上会生成appname.dll和一堆lib*.so/.dylib解压残留 - 调试符号默认不进单文件，如需保留（比如给客户发 release 包还要支持堆栈定位），得加
-p:DebugType=embedded - .NET 6+ 才原生支持 Windows/macOS/Linux 全平台单文件；.NET 5 虽有该参数，但 Linux/macOS 下仍依赖外部运行时
Release 模式下 dotnet publish 生成的 exe 无法运行：提示“找不到指定模块”
这是典型的本地开发环境有完整 SDK，但目标机器只有运行时（Runtime）导致的——单文件只打包你项目直接引用的 DLL，不打包 .NET 运行时本身。除非你用 self-contained 模式。
- 必须加
--self-contained true，否则即使PublishSingleFile=true，也依赖目标机已安装对应版本的 .NET 运行时 - 注意平台标识：Windows x64 要写
-r win-x64，不能漏掉-r（runtime identifier），否则发布结果不包含原生运行时组件 - 如果用了 WPF/WinForms，还得加
-p:PublishTrimmed=false，.NET 6+ 默认启用 Trim，会误删 UI 框架反射需要的类型
如何让单文件 exe 启动时不创建临时解压目录
单文件程序运行时，默认会在 %TEMP%\.net\<appname>\<hash></hash></appname>（Windows）或 $TMPDIR/.net/<appname>/<hash></hash></appname>（Linux/macOS）下解压依赖。这不是 bug，是设计行为——为避免每次启动都解压，.NET 会复用这个目录。想彻底禁用，只能关掉提取机制。
- 加
-p:IncludeAllContentForSelfExtract=false（.NET 6+）或-p:IncludeNativeLibrariesForSelfExtract=false（.NET 5） - 但代价是：首次启动变慢（所有资源从 .exe 内存读取）、内存占用略高、某些依赖原生 DLL 的库（如 SQLitePCLRaw、SkiaSharp）可能失败
- 验证是否生效：运行一次后检查
%TEMP%\.net目录是否存在对应子目录；不存在，说明已纯内存加载
C# 项目引用了第三方 nuget 包，打包后提示“Could not load file or assembly”
不是所有 nuget 包都兼容单文件发布。尤其含 native assets（如 Microsoft.Data.Sqlite、ImageSharp）、或通过 AssemblyLoadContext.LoadFromAssemblyPath 动态加载路径的包，容易在单文件里找不到物理路径。
- 优先选标有
single-file compatible的包；不确定就查其 GitHub Issues，搜 “singlefile” 或 “publishsinglefile” - 强制保留某 DLL 不被合并：在
.csproj中对该PackageReference加<excludeassets>all</excludeassets>，再手动CopyToOutputDirectory，但这就破坏单文件目标 - 更稳妥的做法：改用
AssemblyLoadContext.Default.LoadFromStream()加载嵌入资源里的程序集，而非依赖文件路径
单文件真正的难点不在命令怎么写，而在于运行时行为和开发时的假设不一致——比如“我本地能跑”不等于“单文件里能跑”，尤其涉及文件 IO、反射、原生调用时，临时目录、路径解析、程序集加载顺序全变了。动手前，先在干净虚拟机里测试生成的 exe。
