打包Sublime主题必须分离theme与color_scheme：.sublime-theme放包根目录，.tmTheme放schemes/子目录；资源路径须相对且不依赖User目录；配置示例需含完整后缀、大小写敏感路径及重启提示。
打包前必须确认 theme 和 color_scheme 已分离且可独立运行
自定义皮肤要能被别人直接用，不能把 .sublime-theme 和 .tmTheme 文件硬塞进同一个目录然后指望用户手动配路径。Sublime 的加载机制要求二者物理隔离、逻辑解耦：UI 主题只管界面元素（侧边栏、标签页），配色方案只管编辑区语法色。如果你在 User/ 目录下混着改两个文件，别人 clone 过去根本没法复现——因为 Packages/User/ 是用户私有目录，不会被 Package Control 识别为可安装包。
正确做法是：把 .sublime-theme 放进主题包根目录（如 MyCoolTheme/MyCoolTheme.sublime-theme），把 .tmTheme 单独放在 schemes/ 子目录（如 MyCoolTheme/schemes/MyCoolTheme.tmTheme）。这样别人用 Package Control 安装后，路径自动变成 Packages/MyCoolTheme/...，你的 "color_scheme": "Packages/MyCoolTheme/schemes/MyCoolTheme.tmTheme" 才能命中。
theme 文件里别写绝对路径或 User 专属引用
常见翻车点：有人在 .sublime-theme 的 layer0.tint 或 icon 字段里写 "Packages/User/icons/icon.svg"，或者引用了本地调试时才有的图片资源。这类路径在别人机器上必然 404，Sublime 不报错，只是静默回退默认样式。
- 所有资源路径必须相对 theme 文件自身位置，比如
"icon": "icons/tab-close.png"（前提是icons/tab-close.png确实存在于同包内） - 避免使用
Packages/User/、~/.config/sublime-text/这类用户路径 - 如果用了 SVG 图标，确保它不依赖外部字体或 CSS 样式——Sublime 的 SVG 渲染器极简，只支持基础形状和 fill/stroke
- 测试方法：把整个包目录压缩成 zip，用 Package Control → Install Package → 从本地安装，看是否完全生效
发布前必须提供最小可用 Settings – User 示例
用户不是你，不会猜你要怎么配。90% 的“安装后没变化”问题，根源是他们复制了你的 theme 名但漏了 color_scheme，或者大小写错了连字符。你得在 README 里贴出可直接复制粘贴的配置块：
{
"theme": "MyCoolTheme.sublime-theme",
"color_scheme": "Packages/MyCoolTheme/schemes/MyCoolTheme.tmTheme"
}
注意这三处细节必须显式标注：
-
"theme"值必须带.sublime-theme后缀，不能是MyCoolTheme或My Cool Theme -
"color_scheme"路径必须以Packages/开头，且大小写与实际文件系统完全一致（Linux/macOS 区分大小写） - 必须强调：改完保存后要重启 Sublime Text，ST4 缓存机制会导致热重载失效
图标支持需声明依赖并提供 fallback
如果你的主题依赖 A File Icon 或 FileIcons 来渲染文件图标，不能假设用户已装。要么在 README 里写清依赖项和安装顺序，要么在 .sublime-theme 中为关键 class（如 "class": "icon_file_type"）提供无图标时的尺寸和背景色 fallback：
例如，在 rules 里加一条：
{
"class": "icon_file_type",
"layer0.texture": "none",
"layer0.opacity": 0.0,
"content_margin": [9, 9]
}
这样即使没装图标插件，也不会留白或错位。真正想强依赖图标的话，得在 package control 的 package-metadata.json 里声明 dependencies 字段——但这对纯主题包支持有限，不如文档写清楚来得实在。
最易被忽略的一点：你本地测试时可能开了 material_theme_accent 或 predawn_tabs_autowidth 这类主题专有配置项，它们不会随 theme 自动启用，必须在示例配置里一并列出，否则别人拿到的就是个“残缺版”。
