ColorPicker 必须通过 Package Control 安装，手动复制无效；需确认 Package Control 已正确安装并启用，且文件语法正确、光标位于颜色上下文，macOS 还需授权辅助功能。
ColorPicker 装不上？八成是 Package Control 没跑通
Sublime 本身不带包管理器，ColorPicker 必须通过 Package Control 安装——手动拖文件、解压 ZIP、复制到 Packages 目录，99% 失效。不是插件问题，是加载机制没启动。
- 先确认
Package Control是否真就位：按Ctrl + Shift + P（Win/Linux）或Cmd + Shift + P（macOS），输入Package Control，能列出命令才算成功 - 如果输完没反应，别试第二次——打开控制台（
Ctrl + `），粘贴 ST3 专用安装代码（注意别用 ST2 的旧版，会报NameError: name 'urllib2' is not defined） - 安装后若状态栏没出现
restarting worker类提示，或重启后仍搜不到Install Package，说明下载被拦截或校验失败，得手动下载Package Control.sublime-package放进sublime.installed_packages_path()对应目录
按 Ctrl+Shift+C 没反应？检查三个关键前提
ColorPicker 不是全局可用，它只在“颜色上下文”里触发：光标必须落在支持颜色语法的位置，且当前文件被正确识别为对应语言。
- 光标位置要准：必须停在
color:、background:、border-color:后面的空白处，或已存在的颜色值内部（如#ff6b6b中任意字符上）；写在注释里、JS 字符串中、div标签属性名位置，统统无效 - 文件语法要对：右下角状态栏必须显示
CSS、SCSS、LESS等，不能是Plain text；不对就右键 →Set Syntax→ 选对语言 - macOS 用户额外卡点：系统设置 →
隐私与安全性→辅助功能→ 勾选Sublime Text，否则取色器窗口根本弹不出来
想输入 # 就出常用色板？ColorHighlighter 才管这事
ColorPicker 只负责调系统取色器，# 后自动补全预设色是 ColorHighlighter 的功能，两者互补但完全独立。
- 装完
ColorHighlighter后，打开Preferences → Package Settings → ColorHighlighter → Settings – User - 加一行配置：
"color_schemes": ["#3a86ff", "#8ac926", "#ff006e", "#ffbe0b"]，保存后，在 CSS 文件里输入#再按Ctrl+Space就能唤出补全列表 - 注意：它不识别变量（如
$primary）、函数（如var(--bg)）或非法格式（如#xyz），只认标准颜色字面量
取色器弹出来却插不进代码？看 Python 和路径有没有掉链子
即使快捷键触发成功，取色器窗口也弹了，选完颜色却没插入——常见于 Windows 或 macOS 上 Python 运行时缺失或路径错乱。
- Windows 用户：确保系统已安装 Python 3.7+，且
python --version能正常返回；ColorPicker的 GUI 部分依赖系统 Python，Sublime 自带的 Python 解释器不支持图形界面调用 - macOS 用户：除了辅助功能权限，还要确认 Sublime 是从 Launchpad 或 Finder 正常启动的，别用终端
subl命令直接开——那样继承的是 shell 的环境变量，可能找不到 Python GUI 库 - Linux 用户：部分发行版默认没装
zenity或gdialog，ColorPicker会 fallback 到纯文本输入，此时选完颜色需手动回车确认，不是 bug，是降级行为
真正麻烦的不是装不上，而是装上了但“看起来像没装”——比如快捷键被其他插件劫持、取色器弹窗被系统缩放到看不见、或者光标明明在颜色值上却被语法高亮 scope 错判成普通文本。这些细节不排查，重装十遍也没用。
