企业官网建设流程全解析

• 数据库客户端
• 桌面应用

导读

本篇技术指南围绕 Robo 3T（Robomongo 的跨平台 MongoDB 管理工具）在 Windows 平台上图标（ICO）的生成与尺寸选型展开，完整讲解如何使用 ImageMagick 将icon-set目录下的一组 PNG 素材合成为robomongo.ico，并深入剖析 Windows 各 DPI 缩放级别下系统实际调用的图标尺寸，帮助开发者在打包 Windows 安装包或可执行文件时正确准备图标素材。读完本文，你将能够独立完成 Robo 3T 风格的 Windows 图标构建流程，并为 Windows 7 及更高 DPI 屏幕配置合理的图标尺寸集合。

为什么 Windows 打包需要一份多尺寸 ICO

Robo 3T 的 Windows 分发链路包含三层图标消费场景：

1. 可执行文件图标：构建时由winres.rc资源文件把 ICO 绑定到robo3t.exe上。在 src/robomongo/CMakeLists.txt 中，Windows 构建会读取install/windows/robomongo.ico，通过configure_file将install/windows/winres.rc.in模板填充为winres.rc，并把它作为额外源文件加入robomongo目标；
2. 安装器与卸载器图标：在 cmake/RobomongoPackage.cmake 中，CPACK_NSIS_MUI_ICON与CPACK_NSIS_MUI_UNIICON均指向robomongo.ico，同时安装器界面还使用了 nsis-sidebar.bmp 与 nsis-topbar.bmp 两张位图；
3. 快捷方式与资源管理器：安装完成后，资源管理器、任务栏、开始菜单会按不同尺寸需求从这份 ICO 中抽取对应帧。

因此，这份 ICO 必须包含足够多的尺寸帧，才能保证从 16×16 的列表小图标到 256×256 的高分辨率大图标在各场景下都清晰可用。仓库的icon-set目录已经按 Robo 3T 的实际需要预置了 9 个 PNG 素材：

使用 ImageMagick 从 PNG 生成 ICO

环境准备

首先安装 ImageMagick（官方站点为 www.imagemagick.org）。安装过程中，务必勾选"将 ImageMagick 的实用工具加入 PATH"这一选项，否则convert命令将无法在命令行中直接调用。安装完成后，可在新的命令行窗口中执行convert -version验证 PATH 是否生效。

合成命令

进入install/windows/icon-set目录，执行：

> convert 256x256.png 128x128.png 64x64.png 48x48.png 40x40.png 32x32.png 24x24.png 20x20.png 16x16.png robomongo.ico

命令会按从大到小的顺序读取 9 张 PNG，将它们作为不同尺寸帧写入robomongo.ico，生成的文件即为仓库中 robomongo.ico 对应的产物。执行完成后，可用任意图片查看器或资源管理器直接预览 ICO 内含的多个尺寸帧。

需要留意的是，ImageMagick 的convert默认输出 ICO 时会把各 PNG 帧以 PNG 压缩方式嵌入（适用于现代 Windows），因此生成结果与上述 Windows 7 场景中的"PNG 压缩"建议是一致的。若你的构建目标是仍需兼容 Windows XP 的旧环境，则需按下文"尺寸选择"一节的说明，对 16 至 48 的小尺寸帧采用不压缩的位图格式，可考虑调整输出参数或改用支持逐帧设置压缩方式的专用图标工具。

Windows 图标尺寸选择：哪些尺寸真正被用到

Robo 3T 的 install/windows/README.md 明确指出：小尺寸图标最为关键，Robo 3T 应至少包含 16、20、24、40、48 这五个小尺寸；较大的尺寸通常被系统缩放后仍能保持可接受的画质，因此不必对每个大尺寸都苛求完美。

为了说明这一结论，README 引用了 Windows 7 环境下的一组实测数据（对 8、16、20、24、32、40、48、64、96、128、256 共 11 个候选尺寸的图标进行系统级测试），各 DPI 缩放级别下各应用程序实际使用的尺寸如下：

据此可得出以下关键结论：

• 8 和 32 在所有测试场景中都未被使用（32 从未被用到这一点在原始测试中也被视为反常现象）；
• 128 仅在非常高 DPI 屏幕下的 Windows 照片查看器中出现，实际使用频率极低；
• 对 Windows 7 而言，图标至少应提供 16、48、256 三个尺寸；
• 要完整支持高分辨率新式屏幕，则应提供 16、20、24、40、48、64、96、256 八个尺寸；
• 在 Windows 7 上所有帧都可以使用 PNG 压缩，但若要向后兼容 Windows XP，16 至 48 的小尺寸帧不应压缩。

将这些结论映射到 Robo 3T 的icon-set素材清单，可以看到仓库预置的 9 个 PNG 覆盖了上述全部关键尺寸（16、20、24、32、40、48、64、128、256），其中 32 与 128 属于锦上添花的冗余帧，而 16、20、24、40、48、64、256 等帧正是支撑 100% 到 200% 各 DPI 场景的核心资产。

生成的 ICO 如何进入 Robo 3T 的 Windows 构建流程

生成robomongo.ico只是第一步，构建系统会在三个环节消费这份文件：

1. 可执行文件资源（winres.rc）

Windows 下通过资源编译器（rc.exe）把图标绑定到robo3t.exe。构建流程见 src/robomongo/CMakeLists.txt：

• 将install/windows/robomongo.ico记录到windows_icon变量；
• 用configure_file把模板 install/windows/winres.rc.in 渲染为构建目录下的winres.rc，其中@windows_icon@占位符被替换为 ICO 的绝对路径（模板第 3 行IDI_ICON1 ICON "@windows_icon@"即图标资源声明）；
• 将渲染产物加入robomongo目标，同时将输出目标名设为robo3t（第 236 行）。

该资源模板还顺带携带版本信息：FILEVERSION、PRODUCTVERSION由PROJECT_VERSION_MAJOR/MINOR/PATCH注入，FileDescription为 "Robo 3T, MongoDB management tool"，OriginalFilename为 "robo3t.exe"，Debug 构建额外置位FILEFLAGS 0x1L。

2. NSIS 安装器

在 cmake/RobomongoPackage.cmake 中，CPack 的 NSIS 生成器将robomongo.ico同时指定为安装器与卸载器的图标（CPACK_NSIS_MUI_ICON/CPACK_NSIS_MUI_UNIICON），并配合nsis-topbar.bmp作为安装界面顶部横幅、nsis-sidebar.bmp作为欢迎/完成页侧边栏图像（第 102-103 行）。也就是说，这份 ICO 同时决定了安装包图标与最终安装出的快捷方式图标观感。

3. 其他平台对照

作为跨平台项目的对照组，macOS 侧的图标由 install/macosx/README.md 给出：在install/macosx目录执行iconutil -c icns Robomongo.iconset即可从 iconset 目录生成.icns。Windows 的 PNG→ICO 与 macOS 的 iconset→icns 两条链路相互独立，但都遵循"多尺寸帧打包"的同一原则。

常见问题与建议

• convert 命令找不到：确认安装 ImageMagick 时勾选了加入 PATH，或手动把 ImageMagick 的 bin 目录加入环境变量后重开命令行；
• ICO 在资源管理器里显示模糊：通常是因为缺少 16、20、24、40、48 等小尺寸帧，系统被迫放大其他帧或使用低质量缩放，建议按上文尺寸清单补全；
• 需要兼容 Windows XP：16 至 48 的小尺寸帧应使用非压缩位图格式，而非 PNG 压缩；
• 图标资源未生效：检查winres.rc.in中的@windows_icon@是否被正确替换（即robomongo.ico路径是否正确、文件是否存在），并确认 Windows 构建分支（SYSTEM_WINDOWS）已进入；
• 大尺寸帧不必过度投入：从实测数据看，64 及以上尺寸在多数场景中由系统缩放 256 帧获得，优先保证 256×256 与 16–48 区间的画质即可。

总结

Robo 3T 的 Windows 图标方案可归纳为一条清晰链路：icon-set/*.png → ImageMagick convert → robomongo.ico → winres.rc 资源绑定 / NSIS 安装器引用。其中，尺寸选型的核心依据是 Windows 各 DPI 场景下的实际消费情况——小尺寸（16、20、24、40、48）与 256 帧是必选项，64 与 96 用于高 DPI 增强，32 与 128 则属于低频冗余帧。掌握这套流程后，无论是重新生成图标、替换品牌素材，还是排查 Windows 端图标模糊问题，都能按图索骥、快速定位。

• 数据库客户端
• 桌面应用