VSCode颜色类插件安装失败90%非插件问题，主因是网络不通、权限不足、缓存损坏或签名验证失败；安装卡在“Installing…”多因marketplace连接超时，需查Network面板确认请求状态，优先换国内镜像源并修复~/.vscode/extensions目录权限。
VSCode 颜色类插件（如 Bracket Pair Colorizer、Peacock、Color Highlight）安装失败，90% 不是插件问题，而是 VSCode 扩展系统在下载、校验或激活环节被卡住——网络不通、权限不足、缓存损坏、签名验证失败这四类原因占绝大多数。
扩展安装卡在 “Installing…” 且无报错
这是颜色插件最典型的假死现象。VSCode 实际已停止响应 marketplace 请求，但 UI 没提示，只显示“Installing…”不动。根本原因是它尝试连接 marketplace.visualstudio.com 或 fallback 到 open-vsx.org 时 TLS 握手失败或 DNS 解析超时，尤其在国内网络下常见。
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切到Network标签页，再点一次安装——重点看是否有marketplace.visualstudio.com或open-vsx.org的请求状态为pending超过 20 秒，或返回ERR_CONNECTION_TIMED_OUT - 别急着改代理：VSCode 默认不继承系统 HTTP 代理环境变量，手动填
http.proxy设置后还需加"http.proxyStrictSSL": false才可能生效，但会削弱安全校验 - 更稳的解法是临时换源：关闭 VSCode，编辑
settings.json，把"extensions.gallery.serviceUrl"改成国内镜像，例如："extensions.gallery.serviceUrl": "https://vscode-ext.oss-cn-shenzhen.aliyuncs.com/gallery/" - 重启 VSCode 后再试；若仍卡住，说明不是网络层问题，需往下排查
安装后插件图标灰掉 / 不生效 / 报 Extension activation failed
颜色插件大多轻量，不依赖原生模块，但一旦报 activation 失败，大概率是 VSCode 版本与插件 engines.vscode 声明不匹配，或用户数据目录损坏导致扩展主机（Extension Host）无法加载。
- 打开插件市场页面（如
https://marketplace.visualstudio.com/items?itemName=coenraads.bracket-pair-colorizer），点「Download Extension」拿到.vsix文件，用解压工具打开，查看extension/package.json中的"engines": { "vscode": "^1.85.0" }——你本地 VSCode 版本（Help → About）必须 ≥ 这个最小值 - 如果版本匹配却仍不激活，在输出面板（
View → Output）里切换到Log (Extension Host)，找Activating extension后的错误行，常见有Cannot find module 'vscode'（说明插件包结构异常）或Module version mismatch（Node.js ABI 不兼容） - 执行
code --disable-extensions启动，再逐个启用颜色插件，确认是否与其他插件（尤其是主题、语法高亮类）冲突 - 删掉
~/.vscode/extensions/（macOS/Linux）或%USERPROFILE%\.vscode\extensions\（Windows）下对应插件文件夹，清空后再重装
手动安装 .vsix 提示 EACCES / permission denied
Linux/macOS 用户常遇到这个错误，本质是当前用户对 ~/.vscode/extensions/ 目录没有写权限，而不是 VSCode 自身权限不够。强行用 sudo code 启动只会让后续所有插件都以 root 身份安装，引发更严重的权限混乱。
- 终端执行：
ls -ld ~/.vscode/extensions，如果输出中属主不是你当前用户名（比如显示root），说明之前误用过sudo，需修复：sudo chown -R $USER:$GROUPS ~/.vscode - 检查该目录父路径权限：
ls -ld ~/.vscode，确保至少是drwxr-xr-x（即用户有读写执行权限） - 避免将
extensions.installDir自定义到挂载分区（如 NTFS、exFAT）或系统保护路径（如/usr/local），这些位置不支持原子重命名操作，会导致 .vsix 解压失败 - 用命令行安装比图形界面更可靠：
code --install-extension /path/to/color-highlight-2.5.0.vsix，错误会直接打印在终端，方便定位
真正棘手的是那些没报错、没日志、安装成功但颜色标记就是不出现的情况——这往往意味着扩展主机进程已静默崩溃，而 VSCode 没给出任何提示。此时不要反复重装，先关掉所有 VSCode 进程（包括后台的 Code Helper），再用 --disable-extensions --user-data-dir=/tmp/vscode-test 启动干净环境验证。很多“颜色不生效”问题，其实根源在用户数据目录损坏，而非插件本身。
