彭河森1. 图标这件事，为什么值得单独写一篇
Tauri 2 项目里，图标是个看似简单、实际坑不少的事情。你用 create-tauri-app 脚手架初始化项目后，自带的那套齿轮占位图标，如果不换就直接打包发布，用户第一眼看到的就是一个毫无辨识度的通用图形。我见过不少项目上线后被人吐槽"这个 App 图标怎么像没做完"，其实不是开发者不想做，而是根本不知道图标在 Tauri 里到底该怎么正确生成、生成后该放哪、各个平台的差异又是什么。
Tauri 的跨平台特性让它一次打包可以产出 Windows、macOS、Linux 三个平台的安装包，而这三个平台对图标的格式要求完全不同：Windows 要 .ico，而且需要内嵌多尺寸位图；macOS 要 .icns，有一套严格的视网膜规格；Linux 则只要一堆不同尺寸的 .png，靠目录结构管理。如果你手动去准备这些文件，光是用图形软件导出、逐个重命名、再想办法转格式，就能折腾掉大半个晚上。
Tauri 官方显然意识到这是个高频需求，所以 CLI 内置了一个专门处理图标的子命令：tauri icon。这个命令的角色，可以理解成一个"图标分发器"——你给它一张高质量的源图，它负责把这张图缩放、转换、封装成各平台需要的格式，并且自动更新配置文件。整个过程里，唯一真正需要你花心思的，是那张源图本身。
1.1 一个被低估的工程环节
图标在整个应用工程里位置很微妙。它既不是核心功能代码，也不是架构设计，但它直接决定了产品的第一印象。在 macOS 的 Dock、Windows 的任务栏、Linux 的启动器里，用户还没有打开你的应用，就先看到了这个图标。一个模糊、变形、留白不足的图标，会给产品贴上"业余"的标签。
更现实的问题是，图标不是一次性的工作。应用改版、品牌色调整、节假日限定图标、平台差异化设计，都是后续迭代中经常遇到的需求。如果在项目初期就把图标生成流程理清楚，后面每次换图都是一分钟的事；如果流程混乱，每次改动都要靠手工处理一堆格式，出错的概率成倍上升。
1.2 命令背后的调度逻辑
tauri icon 并不是简单地把一张大图复制几份。它内部做了这些事：读取源图，用图像处理库做高质量缩放，针对不同平台分别编码成对应的容器格式（.ico、.icns、.png），再将生成结果写入 src-tauri/icons 目录，最后自动更新 tauri.conf.json 里的 bundle.icon 配置。搞清楚这个执行链路，你就能理解为什么有些文件生成出来了、有些配置自动改好了，也就能在出问题时快速定位是哪个环节出了问题。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 准备源图：一张图决定所有平台的颜值
2.1 源图硬性规格
tauri icon 对源图的要求其实很宽松，只有两个硬性条件：PNG 格式（或 SVG）、最小尺寸 1024×1024 像素。注意这里是"最小"，不是"恰好"。很多设计工具导出 PNG 时默认带 72 DPI 的元数据，但图标处理只认像素尺寸、不认 DPI，所以只要像素维度达到 1024 就没问题。
实际使用中我强烈建议直接给 1024×1024，这是 Apple 向开发者推荐的图标源图尺寸。向下缩放所有尺寸时都能保持整数倍关系，抗锯齿的边缘最干净。如果你给 1080×1080 也不是不行，但缩放到 16×16 时的采样效果和 1024 源图会略有差异，微小差别在专业眼光下看得出来的。
关于 SVG，Tauri 2 的 icon 命令文档里标注支持 SVG 输入，但要求是带 RGBA 配置文件的方形 SVG。我的建议是：除非你确认 SVG 里只有基础形状和纯色/简单渐变，否则还是转成 PNG 再喂给它。因为 SVG 里的高级滤镜、混合模式在不同的栅格化引擎下渲染结果可能不一样，生成出来的图标在不同平台上出现细微偏差，排查起来很麻烦。
2.2 设计层面的隐形要求
硬性规格只是门槛，真正的分水岭在设计和内容层面。以下是我在多个项目里反复踩过的经验：
安全区。 macOS 会自动给图标应用圆角矩形遮罩，如果你的设计内容顶到了画面边缘，四个角就会被裁掉。Apple 官方的规范是内容保持在画面中央 80% 的安全区内。Windows 虽然不套圆角遮罩，但任务栏小尺寸模式下，边缘细节都会变成噪点，主体内容保持在中央区域同样受益。所以设计源图时，主体元素放在中间约 800×800 的区域内，四周留白。
小尺寸可读性。 16×16 像素下，1024 的大图被压缩到原信息量的几十分之一。线条从 4 像素变成不到 1 像素，基本就看不清了。设计的时候要反复问自己：这张图缩小到 16 像素后还能认出来吗？常用的做法是简化主体轮廓、加粗关键线条、减少渐变色阶的跨度。
避免陪景元素。 我在一个项目里给图标加了水波纹效果，1024 尺寸下很有层次感，但到了 32×32 就完全糊成一片灰色。后来把