我让 AI 给 Sublime Text 换皮肤，踩了四个坑

Sublime Text 是我用了多年的老牌编辑器，快、轻、稳定。但长年累月下来，它的界面还停留在十年前的模样——默认 Mariana 深色配色，没有文件图标，没有 Git 标记，侧栏右键只有可怜的几个选项。

今天心血来潮，决定给它换个 2026 年的新皮肤。这事我没自己动手，而是交给 AI 代劳。没想到，一场「踩坑马拉松」就此展开。

第一步：体检，发现是台「裸机」

AI 上来先给我的 Sublime 做了个全身体检，结果让人意外：

版本 Build 4200，最新版 ✅
Package Control：没装（这意味着任何插件都装不了）
主题、配色：全是默认值，一个没动
系统里倒是早就装好了 JetBrainsMono Nerd Font——支持连字和图标的好字体

也就是说，这是一台装了系统却没装任何软件的「裸机」，美化空间巨大。目标随之定了：Catppuccin Mocha 配色（当下最流行的柔和暗紫灰主题）+ 一套实用全家桶插件。

坑一：行内注释，JSON 解析炸了

AI 先写好配置文件，启动 Sublime——闪退。反复几次。

排查发现，配置里塞了密密麻麻的行内注释（"key": value // 说明）。标准 JSON 解析器看到行内注释会直接报错。虽然 Sublime 自带的 JSONC 解析器能容忍注释，但写配置时还是规范点好——行注释单独占一行，别贪图省事挤在行尾。

坑二：Package Control「装死」

装好 Package Control 后，把八个插件写进清单，指望它启动时自动拉取。等了整整 90 秒——一个包都没下载下来。

第一反应是网络问题。测试发现，channel 数据 4MB 正常拿到，GitHub 也通。网络是无辜的。

真正的原因藏得更深：Package Control 的自动拉取有时序依赖，首次 bootstrap 没跑完，它就装作没看见你的清单。

坑三：包名写错，白等一场

翻 channel 元数据时，发现了更尴尬的事：我要装的 Catppuccin，在 Package Control 里的注册名根本不叫 "Catppuccin"，而是 "Catppuccin color schemes"。

名字对不上，自然永远拉不到。这种「我以为叫什么」和「它实际叫什么」的错位，是手动写包清单时最容易踩的雷。

坑四：配色文件路径对不上

绕过自动拉取，直接 git clone 八个包到本地。打开 Catppuccin 仓库一看——配色文件不叫 Mocha.sublime-color-scheme，而在 build/ 目录下，全名是 Catppuccin Mocha.sublime-color-scheme（带空格）。

路径写错，启动就报 "Unable to find colour scheme"。改对路径，世界清静。

破局：手动 clone，绕过时序

连续踩坑后，AI 换了思路：既然自动拉取不靠谱，那就手动来。从 channel 元数据解析出每个包的真实 GitHub 地址，逐个 git clone --depth 1 到 Packages 目录。

八个包，三分钟全部到位：Catppuccin（配色）、A File Icon（侧栏图标）、SideBarEnhancements、BracketHighlighter、GitGutter、MarkdownEditing、AutoFileName、Terminus。

最后修正配色路径，重启——柔和的暗紫灰底色铺开，JetBrainsMono 的 => !== 自动连成优雅的箭头，侧栏每个文件都有对应的彩色图标，Git 改动在行号栏实时标记。十年老编辑器，焕然一新。

三条干货

折腾完这一圈，总结三条避坑经验：

配置文件别用行内注释。JSON 规范是底线，行注释单独成行。
包名以 channel 元数据为准。别凭记忆写，先查 channel_v3.json 里的注册名。
自动拉取不可靠就手动 clone。Package Control 的时序问题无解，直接 git clone 到 Packages 目录最快最稳。

写在最后

让 AI 代劳美化编辑器，听起来是句口令的事，实际藏着无数细节：包名、路径、解析器、时序。AI 不是不靠谱，而是它和你一样，得在一次次报错里摸清这个工具的真实脾气。

过程有点波折，但结果值得。下次你想给手头的工具换个新面貌，不妨也试试——记得，报错不可怕，可怕的是不知道错在哪。