Chromium 品牌与产品定制：名称、图标、默认设置和用户目录

归档与更新说明： 本文归入 2018 年 Chromium 二次开发专题，并于 2026-09-28 重新整理。Chromium 的分支、构建参数和依赖变化很快，实际操作请同时核对对应版本的官方文档与源码。

浏览器产品定制远不止替换一个图标。名称、资源、包标识、用户数据目录、默认设置和更新通道相互关联；如果只改表面资源，很容易与系统中已有浏览器发生冲突。

品牌资源

产品名称、图标、安装包名称和可执行文件描述应在各平台保持一致。需要明确区分 Chromium 的开源代码与第三方商标、服务和素材，不能因为源码可用就默认拥有其他品牌的使用权。

独立的产品身份

至少检查以下项目：

• Windows AppUserModelID、注册表项、卸载信息与快捷方式；
• macOS bundle identifier、签名身份和 entitlement；
• Linux desktop 文件、包名和图标缓存；
• 默认用户数据目录、缓存目录和日志目录；
• 协议处理器、文件关联和“默认浏览器”注册；
• 稳定版、测试版和开发版之间的 channel 隔离。

用户数据目录尤其重要。如果自定义浏览器与 Chrome 或 Chromium 共用 profile，版本差异可能损坏偏好、扩展和数据库，也会给卸载与回滚带来风险。

默认配置不等于强制配置

首页、搜索、隐私选项和首启页面通常应作为“首次默认值”，而不是每次启动都覆盖用户选择。企业强制项则应通过明确的策略层实现，并在界面中让用户知道设置受管理。

第三方服务

同步、翻译、安全浏览、崩溃上传、更新和搜索建议等能力可能依赖服务端 API、授权或隐私条款。删除不可用服务时，要同时清理入口、后台请求、错误重试和用户提示，不能只隐藏按钮。

验收清单

使用全新系统账户测试首次启动、升级、降级、卸载保留数据、多版本并存和默认浏览器切换。再检查网络请求、证书、崩溃日志及隐私说明是否与实际行为一致。

产品化的目标，是让浏览器在操作系统看来拥有清晰、稳定且可升级的独立身份。