如何为C#导出的单文件exe设置自定义图标

两种方式都可实现单文件exe的自定义图标配置，以下是具体操作步骤以及属性配置不生效的常见排查方案：

这是官方推荐的标准化配置方案，你之前配置未生效大概率是操作有遗漏或者缓存问题，按以下步骤操作即可：

• 提前准备标准.ico格式图标，建议内置1616、3232、4848、256256四种分辨率，避免不同场景下图标显示异常
• 将图标文件放到C#项目的根目录下
• 右键项目→选择「属性」→切换到「应用」标签页，在「资源」分类的「图标」选项中选中你准备好的ico文件，保存配置
• 发布单文件前先执行清理操作：右键项目→点击「清理」，手动删除项目根目录下的bin、obj文件夹，避免旧缓存影响编译
• 正常执行单文件发布操作即可，图标会自动嵌入生成的exe中

配置后不生效的常见排查点：

• 图标格式不规范，直接改后缀名得到的ico文件无法被正常识别
• 使用.NET Core 3.0的早期版本，该版本存在单文件发布不嵌入图标的已知bug，升级到.NET Core 3.1以上版本即可修复
• 发布时的命令行参数覆盖了项目属性的图标配置，移除参数里的图标相关配置项即可

分为发布时指定图标、已生成exe追加图标两种场景：

2.1 发布时通过命令直接指定图标 #

无需修改项目属性，在执行dotnet publish命令时直接传入图标参数即可：

dotnet publish -c Release -r win-x64 /p:PublishSingleFile=true /p:SelfContained=true /p:Win32Icon=你的图标文件完整路径.ico

按需修改命令里的运行时（-r参数）和图标路径即可。

2.2 已生成的单文件exe直接追加图标 #

如果不想重新发布，可以通过ResourceHacker的命令行工具直接修改exe的资源：

• 先将ResourceHacker的安装路径添加到系统环境变量，确保控制台可以直接调用
• 执行以下命令：

ResourceHacker.exe -open 原单文件.exe -save 加图标后.exe -action addoverwrite -res 自定义图标.ico -mask ICONGROUP,MAINICON,0

• 注意：修改后原exe的数字签名会失效，如果需要签名请在修改完成后重新进行签名操作

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