colonize插件因依赖已废弃的vscode.workspace.onwillsavetextdocument api，在vscode 1.79+中彻底失效，表现为插件inactive、命令不可用、快捷键无响应；推荐改用prettier+eslint自动格式化或自定义代码片段实现分号添加。

Colonize 插件已停止维护，且不兼容 VSCode 1.80+（2024 年起默认禁用旧式插件），无法可靠实现行尾分号/逗号的快捷添加。 它依赖已被移除的 vscode.workspace.onWillSaveTextDocument API，启用后常导致保存卡顿、格式化失效或直接报错 Command 'colonize.toggle' not found。

为什么 Colonize 在新版 VSCode 中根本不能用

VSCode 自 1.79 起逐步废弃旧版插件 API，Colonize 使用的监听保存事件方式被彻底替换为 onWillSaveTextDocument 的新异步模型，而该插件从未更新。实际表现包括：

• 安装后插件状态显示 Inactive，右下角无图标，Ctrl+Shift+P 搜不到 Colonize: Toggle
• 手动启用会触发警告：This extension uses deprecated APIs and may not work in future versions
• 即使临时绕过警告，按下绑定快捷键也无响应，控制台报错 TypeError: Cannot read property 'document' of undefined

替代方案：用 Prettier + ESLint 自动补全分号/逗号

现代前端项目应交由格式化工具统一处理，而非手动快捷键。关键不是“加”，而是“保持风格一致”：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• prettier.config.js 中设 semi: true（强制分号）或 semi: false（无分号）
• .eslintrc.cjs 加规则："semi": ["error", "always"] 或 "semi": ["error", "never"]
• VSCode 设置中开启 editor.formatOnSave 和 editor.codeActionsOnSave → {"source.fixAll.eslint": true}
• 保存时自动补全分号/逗号，并修正位置（比如对象末尾逗号、import 多行末尾等）

如果非要手动快捷添加：用自定义 snippet + 快捷键

适用于临时编辑非工程文件（如 Markdown 内代码块、JSON 片段），不推荐用于正式代码：

• 打开 Code > Preferences > Configure User Snippets，选 javascript.json
• 添加片段：

  {
    "Semicolon at end": {
      "prefix": ";",
      "body": ["$1;"],
      "description": "Add semicolon at cursor"
    }
  }

• 再在 keybindings.json 中绑定：

  [{
    "key": "ctrl+;",
    "command": "editor.action.insertSnippet",
    "args": { "name": "Semicolon at end" },
    "when": "editorTextFocus && !editorReadonly"
  }]

• 注意：此法只在光标处插入 ;，不会识别语句边界；对 if (x) { ... } 这类块结构无效

真正需要关注的是项目级格式规范是否落地——Prettier 配置写错一个字段，比找十个快捷键插件都容易出问题。别在已淘汰的插件上浪费调试时间。