English | 中文

Code Highlight As You Want

通过快捷键为选中的代码段快速应用半透明高亮，方便在阅读、Review、调试时标记关键代码。

功能特性

• 10 种半透明高亮颜色：默认全部使用 rgba(...,0.35~0.40) 半透明色，不会遮盖代码文字，并在右侧滚动条/小地图标记位置。
• 快捷键应用：选中代码段后按对应快捷键即应用高亮；未选中时高亮光标所在整行。
• 自定义颜色：在设置中修改 10 种颜色，保存后高亮立即按新颜色刷新。
• 跟随文本防漂移：编辑代码时，高亮范围会随插入/删除文本实时调整；高亮被压缩为空时自动移除。
• 清除单个高亮：右键菜单清除光标位置的所有颜色高亮。
• 按颜色清除：QuickPick 选择某种颜色，仅清除该颜色的高亮。
• 撤销最近高亮：Ctrl+Alt+Z 撤销最后一次添加的高亮。
• 跳转导航：Ctrl+Alt+] / Ctrl+Alt+[ 在高亮之间前后跳转，到边界自动环绕。
• 状态栏计数：右下角显示当前文件高亮总数，无高亮时隐藏。
• 跨 PC 共享：高亮数据可保存到项目内 .vscode/code-highlights.json，纳入 git 后即可在其他 PC 还原。

适用的编辑器

本扩展基于 VS Code Extension API 开发，同时适用于以下编辑器：

快捷键一览

右键菜单还提供：清除光标处高亮、跳转下一个/上一个、撤销、按颜色清除。

说明：Ctrl+1/2/3 在 TRAE/VS Code 中默认绑定"切换编辑器组"，本扩展在编辑器文本聚焦时（editorTextFocus）会优先接管；若仍冲突可在「键盘快捷方式」中自行调整。

安装方法

在 TRAE IDE 中安装

1. 打开 TRAE IDE，点击左侧导航栏的 插件市场 图标。
2. 点击面板右上角 ··· → 从 VSIX 安装。
3. 选择本扩展的 .vsix 文件。
4. 安装完成后即可使用，无需重新加载。

在 VS Code 中安装

同样通过扩展面板的 ··· → 从 VSIX 安装 导入 .vsix 文件。

配置说明

在设置中搜索 代码高亮 或 codeHighlighter。

codeHighlighter.colors

10 种高亮颜色数组，顺序对应 Ctrl+1、Ctrl+2 ... Ctrl+9、Ctrl+0。每项为 CSS 颜色字符串，建议使用 rgba 半透明色（alpha 建议 0.25~0.45），以避免与代码文字颜色混淆。

默认值：

"codeHighlighter.colors": [
  "rgba(255, 99, 132, 0.35)",
  "rgba(255, 159, 64, 0.35)",
  "rgba(255, 205, 86, 0.40)",
  "rgba(75, 192, 192, 0.35)",
  "rgba(54, 162, 235, 0.35)",
  "rgba(153, 102, 255, 0.35)",
  "rgba(255, 132, 213, 0.35)",
  "rgba(100, 220, 180, 0.35)",
  "rgba(180, 220, 100, 0.40)",
  "rgba(180, 180, 200, 0.35)"
]

修改后高亮会立即按新颜色刷新，无需重启。

codeHighlighter.sharedInProject

是否将高亮数据保存到项目内 .vscode/code-highlights.json 文件。

• true（默认）：高亮随项目共享给其他 PC，需将该文件纳入 git。
• false：仅保存在本机工作区状态中，不跨 PC。

切换该选项时，扩展会自动重新加载数据并刷新显示。

跨 PC 共享使用方法

1. 在 PC-A 中正常使用高亮，扩展会自动在项目根目录生成 .vscode/code-highlights.json。
2. 执行 git add .vscode/code-highlights.json 并提交推送。
3. PC-B 拉取后打开同一项目，高亮自动还原。
4. 任一 PC 修改高亮后，共享文件会被重写；其他 PC 通过文件监听自动刷新（需文件被同步到本地）。

注意：跨 PC 共享时，不同人若同时编辑同一文件，高亮行列会因各自本地改动而错位——这是高亮类扩展的固有局限，防漂移仅在本机编辑时生效。

命令一览

除快捷键外，所有功能都可在命令面板（Ctrl+Shift+P）中搜索「代码高亮」调用：

• 代码高亮: 颜色 1~10
• 代码高亮: 清除当前文件全部高亮
• 代码高亮: 清除光标处高亮
• 代码高亮: 撤销最近一次高亮
• 代码高亮: 按颜色清除...
• 代码高亮: 跳转到下一个高亮
• 代码高亮: 跳转到上一个高亮

高亮重叠规则

• 在同一代码段多次添加高亮时，新范围会从所有颜色的现有高亮中切除重叠部分，保证任意位置始终只显示一层高亮。
• 被覆盖区域的旧颜色会被切分或移除，仅保留最新添加的颜色。
• 相邻（不重叠）的高亮各自保留，互不影响。
• 撤销（Ctrl+Alt+Z）不仅移除最近添加的那一段，还会恢复该次操作中被切除的旧片段，回到添加前的状态；仅当被切除的剩余片段在对应颜色中仍精确存在时才恢复，避免因后续操作改变而产生错误重叠。

已知限制

• 防漂移对单次事件内多个不重叠变更已做处理；极少数复杂重叠编辑可能有微小误差。
• 跨 PC 共享时，多端同时编辑同一文件会导致高亮位置错位，需手动同步。
• 多根工作区（Multi-root Workspace）只使用第一个文件夹作为共享文件根。
• 高亮本身不是源码的一部分，跨机共享时漂移问题会比本机更明显。

从源码构建

环境要求：Node.js、npm。

# 安装依赖
npm install

# 编译 TypeScript
npx tsc -p ./

# 打包成 vsix
npx vsce package --no-git-tag-version

生成的 code-highlight-as-you-want-x.x.x.vsix 即可直接安装。

许可证

本项目基于 MIT License 开源。

Copyright (c) 2026 AC-kiko