ColorPicker 在 Sublime Text 4 中完全不可用,因其依赖的 tkinter、winreg、sublime_api 等模块被 Python 3.8+ 插件沙箱彻底移除;唯一可靠替代是 ColorHelper,它基于语法作用域解析颜色,支持 #rrggbb、hsl()、oklch()、var(--color) 等现代格式,光标悬停实时预览,Alt+Shift+C(Win/Linux)或 Opt+Shift+C(macOS)呼出面板。

ColorPicker 在 Sublime Text 4 中根本不能用,不是安装步骤错了,而是它依赖的 tkinter、winreg、sublime_api 等模块已被 ST4 的 Python 3.8+ 插件沙箱彻底移除。你看到“安装成功”、文件夹存在、甚至控制台没报错——这些全是假象,插件压根没初始化,命令不注册,快捷键无响应。
确认你的 Sublime Text 版本是否支持 ColorPicker
打开 Help → About Sublime Text,看 Build 号:
- Build
4xxx(如4143)→ 直接放弃ColorPicker,它在架构层面被禁用 - Build
3xxx(如3211)→ 还需检查:Preferences → Package Settings → ColorPicker → Settings 中是否有"enable_gui": true(默认常为false或缺失) - Windows 用户必须已安装
pywin32;macOS 用户需pyobjc,否则即使 ST3 也会静默失败
ColorHelper 是 Sublime Text 4 唯一可靠替代
ColorHelper 不调系统 GUI,纯靠语法作用域解析颜色,天然兼容 ST4,且支持现代格式:
- 识别
#rrggbb、rgb()、hsl()、oklch()、var(--color)、bg-blue-500等 - 光标停在颜色值上,右侧自动显示小色块预览
- 呼出完整面板:Windows/Linux 按
Alt+Shift+C,macOS 按Opt+Shift+C - 启用
"enable_color_variables": true后可解析 CSS 自定义变量
安装 ColorHelper 必须走标准路径
手动拖 .sublime-package 文件或改配置项都无效,唯一有效方式是:
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS) - 输入
Package Control: Install Package回车 - 等右下角 “Loading packages…” 消失后再输入
ColorHelper(大小写敏感)回车 - 装完立刻验证:Preferences → Browse Packages 中是否存在大小写准确的
ColorHelper文件夹
ColorHelper 快捷键没反应?先查键位冲突
默认快捷键 Alt+Shift+C 极易被微信、QQ、输入法或你自己的 Default (Windows).sublime-keymap 劫持:
- Windows 路径:
C:\Users\XXX\AppData\Roaming\Sublime Text\Packages\User\Default (Windows).sublime-keymap - macOS 路径:
~/Library/Application Support/Sublime Text/Packages/User/Default (OSX).sublime-keymap - 用 Sublime 打开该文件,搜索
alt+shift+c或ctrl+shift+c - 删掉冲突条目,或改为
["alt", "ctrl", "shift", "c"],保存后立即生效,无需重启
真正卡住人的地方不在安装,而在「以为装了就能用」——ST4 的沙箱机制让所有依赖系统 GUI 的插件失效得悄无声息。预览不出现、快捷键无响应、命令搜不到,都不是配置问题,是底层能力缺失。别试降级、别碰旧版 colorpicker.py、别信 "enable_gui": true,这些在 ST4 上连入口都进不去。











