Alacritty Windows 配置指南：图标替换、高 DPI 清单与安装包打包
【免费下载链接】alacrittyA cross-platform, OpenGL terminal emulator.项目地址: https://gitcode.com/GitHub_Trending/al/alacritty
Alacritty 是一款基于 OpenGL 的跨平台 GPU 终端模拟器。在 Windows 上从源码构建它时，任务栏图标、高 DPI 显示效果和安装程序外观，都由alacritty/windows/目录下的三个资源文件决定。这篇文章带你走通一条完整链路：把默认图标换成自己的、按需调整 DPI 行为、最后用 WiX 打出带新图标的 MSI 安装包，并告诉你每一步在哪里验证是否生效。
图标和清单是在哪一步打进 exe 的
先说结论：Windows 下图标与清单在编译阶段就嵌入可执行文件，不改动资源文件，重装多少次图标都不会变。
三处关键代码串起了这条链路：
- alacritty/rc 资源脚本：声明了两件事——
IDI_ICON指向alacritty.ico，RT_MANIFEST指向alacritty.manifest。 - build.rs：Windows 平台编译时调用
embed_resource::compile("./windows/alacritty.rc")并强制要求嵌入 manifest。也就是说cargo build会自动完成图标和清单的嵌入，无需手动注册任何资源。 - 窗口模块源码：定义了与资源文件一致的图标 ID（
0x101），运行时用它从 exe 中取出窗口图标。
所以只要搞清楚"资源文件 → 编译 → exe → 安装程序"这条流水线，后面的定制都是顺着流水线操作。
替换 Windows 图标只需改两个地方
图标生效位置只有两处：exe 里的窗口图标，以及安装程序里引用的 ICO 文件。
操作步骤：
- 准备好一套多尺寸 PNG（常见档位：16、32、48、64、128、256 像素），用一个图标编辑工具（如 Greenfish Icon Editor Pro、IcoFX）打包成 ICO。
- 用新文件覆盖 alacritty/windows/alacritty.ico。这是 exe 嵌入的图标来源，决定任务栏、窗口标题栏的外观。
- 检查 WiX 安装项目：其中
<Icon ... SourceFile=".\alacritty\windows\alacritty.ico" />通过ARPPRODUCTICON决定"程序和功能"、快捷方式上显示的图标。由于它指向同一个路径，覆盖 ICO 后自动同步，无需额外修改。 - 重新执行
cargo build --release让新图标嵌入 exe。
注意：Windows 对资源文件有系统级缓存。如果你直接覆盖安装目录里的 exe，可能仍看到旧图标。最稳妥的验证方式是通过重新打包的安装程序全新安装，或改名替换 exe 后再观察。
DPI 清单：多显示器场景该保留 PerMonitorV2
默认清单已经给出多显示器场景下的推荐值，多数人不需要改。
清单文件 alacritty/windows/alacritty.manifest 的核心内容只有一段声明：
<asmv3:windowsSettings ...> <dpiAwareness>PerMonitorV2, unaware</dpiAwareness> </asmv3:windowsSettings>各取值对应的显示行为如下：
| 取值 | 行为 | 适合场景 |
|---|---|---|
PerMonitorV2 | 每个显示器独立 DPI 感知，应用自己按缩放比渲染 | 多显示器、混合缩放比（默认，建议保留） |
PerMonitor | 旧版按显示器感知 | 需要兼容旧行为的场景 |
System | 按系统级缩放统一处理 | 单显示器且追求简单 |
unaware | 不参与感知，由系统位图缩放，画面可能发虚 | 极少数刻意规避缩放的场景 |
由于清单在编译期嵌入 exe（见上文build.rs的处理），改完<dpiAwareness>后必须重新cargo build --release才会生效，直接改安装目录里的文件是无效的。
用 WiX 生成 MSI 安装包
安装包项目位于 alacritty/windows/wix/，打包前必须先在仓库根目录完成一次 release 构建。
alacritty.wxs 里几个与本次定制直接相关的配置项：
| 配置项 | 作用 |
|---|---|
<Icon SourceFile=".\alacritty\windows\alacritty.ico" /> | 安装包属性页与快捷方式使用的图标 |
Source=".\target\release\alacritty.exe" | 被打包的主程序，即上面重新编译出的 exe |
<WixVariable Id="WixUILicenseRtf" .../> | 指向license.rtf，安装向导的许可协议文本 |
ContextMenu相关组件 | 注册"在此处打开 Alacritty"右键菜单 |
按 WiX Toolset v4 的常规流程（以你本地安装的版本帮助文档为准）：
- 仓库根目录执行
cargo build --release，确认target/release/alacritty.exe已生成。 - 在
alacritty/windows/wix/目录用 WiX 命令行工具（如wix msbuild alacritty.wxs或 candle/light 组合）编译出 MSI。 - 生成的 MSI 会携带新图标、新清单和右键菜单项，安装后即可看到全部定制效果。
如果只想验证图标和 DPI 效果，也可以跳过打包这一步：直接运行target/release/alacritty.exe观察任务栏图标，把窗口拖到不同缩放比的显示器之间确认清晰度。
验证清单与常见疑问
安装完成后，按下面 5 项逐条确认即可：
- "设置 → 应用"中 Alacritty 的图标是否为新图标，还是系统默认程序图标。
- 桌面/开始菜单快捷方式图标是否已更新（受缓存影响时可重建快捷方式）。
- 任务栏与窗口标题栏图标是否一致。
- 在两个不同缩放比的显示器间拖动窗口，文字应保持锐利、布局不跳变。
- 在资源管理器空白处右键，确认"Open Alacritty here"菜单存在且工作目录正确。
几个常见疑问：
- 换了图标重启后没变化？大概率是资源缓存或旧文件未真正替换，建议通过新打包的 MSI 干净安装后再看。
- 只改 manifest 不重新编译？不生效。清单在编译期嵌入，必须以重新构建的 exe 为准。
- 想要更细的界面定制？图标和 DPI 属于"系统外壳"层面；窗口尺寸、字体、光标、配色等行为由配置文件控制，参见 配置文档 和 alacritty_config 模块。
- 贡献修改？按 CONTRIBUTING.md 的流程提交，图标资源改动最好附带替换前后的对比截图。
【免费下载链接】alacrittyA cross-platform, OpenGL terminal emulator.项目地址: https://gitcode.com/GitHub_Trending/al/alacritty
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
