<p>ClickOnce 在现代 C# 项目中已不推荐使用，因其无法安装服务、写注册表，受限于路径访问与更新调试；.NET 6+ 项目需手动配置 .csproj 才能启用发布菜单，且更新需版本号递增与可访问发布路径。</p>
ClickOnce 部署在现代 C# 项目中已不推荐用于新项目，尤其在 .NET 6+、WPF/.NET MAUI 或需要离线更新/权限控制的场景下，它存在明确限制：无法安装服务、不能写注册表、默认禁止访问用户文档外路径、更新逻辑黑盒且难以调试。
为什么 Publish 菜单点不动或提示“未启用 ClickOnce”
Visual Studio 默认对新创建的 .NET Core/.NET 5+ 项目禁用 ClickOnce。它只原生支持面向 net472 及以上（即传统 .NET Framework）的 WinForms/WPF 项目。
- 若你用的是
net6.0-windows或更高版本的 WPF 项目：必须手动编辑.csproj，添加<IsWebBootstrapper>false</IsWebBootstrapper>和<PublishUrl>..publish</PublishUrl>等属性，否则右键“发布”菜单直接灰掉 - VS 2022 17.4+ 对 .NET 6+ 的 ClickOnce 支持仍属实验性，生成的
setup.exe可能无法静默安装或校验签名 - 检查项目属性 → “发布”页签是否可见；不可见则说明 SDK 类型不匹配，别硬改配置，先确认目标框架
ApplicationDeployment.CurrentDeployment 报 InvalidDeploymentException
这是运行时最常见错误，本质是部署元数据缺失或不一致——不是代码写错，而是发布产物没按 ClickOnce 规范组织。
- 确保发布后生成的文件夹里包含
Application Files子目录、.application清单文件、以及带哈希后缀的程序集（如MyApp.exe.deploy） - 不要手动重命名或移动
.deploy文件；它们必须和清单中声明的名称、版本、哈希值完全一致 - 调试时若从 Visual Studio 直接运行（非双击
MyApp.application），CurrentDeployment必然为null—— 它只在通过 ClickOnce 启动器加载时才被初始化
如何让更新检测生效（CheckForUpdateAsync() 总返回 false）
ClickOnce 的更新机制依赖两个关键条件：发布版本号变更 + 发布位置可访问。缺一不可。
- 每次发布前必须在项目属性 → “发布” → “应用程序更新”中勾选“应用程序应该检查更新”，并设置“更新频率”；否则生成的清单不包含更新策略
- 版本号必须手动递增（如从
1.0.0.0改为1.0.0.1），自动递增仅在发布到网络路径时由 VS 计算，本地文件夹发布不会自动加版本 - 若发布到本地文件夹（如
file://C:/myapp/），客户端需有完整读取权限；Windows 10/11 默认阻止 file:// 协议的 ClickOnce 应用启动，需改用 HTTP 或 UNC 路径（如\servershare）
真正棘手的不是怎么配，而是它把部署逻辑和应用逻辑耦合进同一套 XML 清单体系里——一旦 MyApp.exe.manifest 中某个依赖的哈希值与实际文件不符，整个更新就会静默失败，连日志都不输出。调试时建议用 mage.exe -verify 手动校验清单完整性，而不是靠弹窗报错来定位问题。
