MSIX 打包必须使用 Visual Studio 2019 或更新版本并安装 UWP 工作负载，主项目需设为自包含单文件发布、正确配置 TargetFramework 与 TargetPlatformMinVersion，引用原生 NuGet 包，签名证书须受信任，调试需启用启动项目和本地部署。
MSIX 打包必须用 Visual Studio 2019 或更新版本
旧版 VS（如 2017）不支持 MSIX 项目模板，强行用 MakeAppx.exe 手动打包会缺失签名、依赖解析和 AppXManifest 校验，导致安装失败或运行时崩溃。确认 VS 版本后，需安装「Universal Windows Platform development」工作负载，否则新建项目时看不到 Windows Application Packaging Project 模板。
常见错误现象：error APPX0501: The manifest file does not conform to the schema——多半是项目未正确关联 UWP 目标平台或 TargetPlatformMinVersion 低于系统支持版本。
- 确保主应用项目（如 WPF/WinForms）的
TargetFramework为net6.0-windows10.0.19041.0或更高（推荐net8.0-windows10.0.22621.0） - 打包项目属性中，
TargetPlatformMinVersion不能低于主项目所用的最低 Windows 版本 - 若引用了第三方 NuGet 包（如
Microsoft.Data.Sqlite），需确认其含win-x64或win-arm64原生二进制，否则打包后运行时报DLLNotFoundException
WPF/WinForms 项目必须启用“单文件发布 + 自包含”模式
MSIX 不接受。NET 运行时动态下载，所有依赖必须打包进包内。默认的“框架依赖型”发布方式会导致安装后启动闪退，错误日志里常出现 0x80070002 或Failed to load hostfxr.dll。
实操关键点：
- 在打包项目属性 → «Package Manifest» → «Application» 页签，勾选«Generate App Bundle»并设为«Always»
- 主应用项目的
.csproj中显式添加：<PropertyGroup> <PublishTrimmed>false</PublishTrimmed> <SelfContained>true</SelfContained> <PublishSingleFile>true</PublishSingleFile> <RuntimeIdentifier>win-x64</RuntimeIdentifier> </PropertyGroup> - 若需支持 ARM64 设备，须单独为
win-arm64生成一个 MSIX 包，MSIX 不支持多 RID 混合打包
证书签名是安装前提，自签名证书必须被信任
未签名的 MSIX 只能通过 PowerShell 用 Add-AppxPackage -Register 临时注册，且每次重启后失效；双击安装必然失败，提示error 0x800B0109: A certificate chain processed, but terminated in a root certificate which is not trusted by the trust provider。
解决路径：
- 用
MakeCert.exe或New-SelfSignedCertificate生成 pfx 证书，注意指定-Type CodeSigning - 将该证书导入当前用户「受信任的根证书颁发机构」存储区（非「个人」区）
- 在打包项目属性 → «Signing» 页签中，选择 pfx 文件并填入密码；勾选«Sign the package after build»
- 若用 Azure Pipelines 或 GitHub Actions 自动化构建，需把 pfx Base64 编码后存为 secret，并在 CI 脚本中解码写入临时文件再签名
调试阶段禁用“仅限本地部署”，否则无法附加调试器
打包项目默认启用«Do not launch application after deployment»，且调试时 VS 尝试以受限上下文启动，导致断点不命中、Debugger.Launch()无响应、甚至 App.xaml.cs 中的初始化逻辑被跳过。
必须调整两项设置：
- 打包项目属性 → «Debug» 页签，取消勾选«Do not launch application after deployment»
- 同一页面，将«Start action»改为«Start project»（而非«Start external program»）
- 若主项目是 WPF，还需在
App.xaml中确认StartupUri未被注释，且OnStartup中避免调用需要高权限的 API（如注册表写入），否则调试时弹 UAC 框中断流程
