VB.Net WinForm ClickOnce应用安装失败：无法下载窗体图标

排查与修复方案 #

1. 核对图标文件的发布配置 #

右键项目 → 属性 → 发布 → 应用程序文件，找到你的窗体图标文件（比如Form1.ico）：

• 保证发布状态是包含(自动)，别设成排除或数据文件——设成数据文件会被ClickOnce当成独立资源，容易出现下载路径异常
• 确认下载组为(Required)，确保安装阶段优先下载该资源

2. 清理客户端ClickOnce缓存 #

客户端本地的缓存损坏可能导致资源下载失败：

• 按下Win + R，输入 rundll32 dfshim CleanOnlineAppCache 回车执行，清空本地ClickOnce缓存
• 重启电脑后再运行.application文件重试安装

3. 检查图标文件的属性与输出设置 #

• 右键图标文件 → 属性，取消只读勾选，若有加密选项也一并取消
• 同样在图标文件的属性里，把复制到输出目录设为始终复制或如果较新则复制，确保发布时图标能被正确打包到输出目录

4. 手动修正部署清单文件 #

自动生成的清单可能存在路径错误：

• 发布后找到部署目录下的Application Files文件夹，打开对应版本的.manifest文件（用记事本或VS打开）
• 查找图标对应的<file>节点，确认name属性的路径正确（比如是Form1.ico而非带错误层级的路径），修正后保存，再重新运行.application

5. 细化共享驱动器的权限与路径检查 #

• 确认共享驱动器的高级共享权限和本地文件夹的安全选项卡，都给目标用户组分配了读取和列出文件夹内容的权限
• 尝试把图标单独放到共享根目录，重新发布项目测试，排除文件夹层级导致的路径解析问题

6. 关闭ClickOnce增量更新 #

增量更新可能遗漏资源：

• 项目属性 → 发布 → 更新，取消勾选启用增量更新，重新发布后测试

内容的提问来源于stack exchange，提问作者Code_Geass