vscode插件默认按需激活，需在activationevents中显式声明触发条件；语言插件须匹配真实languageid（如typescript而非javascript），多语言用数组声明；oncommand适用于命令型插件，workspacecontains检测工作区根目录文件，onfilesystem用于远程文件系统场景。
插件为什么没在打开文件时自动激活？
VSCode 插件默认不随编辑器启动，而是按需激活——只有满足 activationEvents 中声明的条件时才加载。常见误解是“装完就生效”，实际若没配对触发事件，插件可能全程未被加载，contributes.commands 或 contributes.languages 都不会注册。
典型现象：插件有命令但 Ctrl+Shift+P 里搜不到；语言服务器没启动；右键菜单不出现；package.json 里写了 language 但语法高亮/诊断无响应。
-
activationEvents必须显式声明，空数组[]表示仅在插件启用时加载（几乎无用） - 常用触发项优先级：打开特定语言文件 > 执行某命令 > 激活某视图 > 编辑器聚焦
- 多个事件用数组写，VSCode 满足任一即激活，无需全部命中
如何为语言类插件配置正确 activationEvents？
语言插件最常错配成 "onLanguage:javascript" 却在打开 .ts 文件时失效——因为 TypeScript 文件默认 language ID 是 typescript，不是 javascript。
查真实 language ID 的方法：Ctrl+Shift+P → 输入 Developer: Inspect Editor Tokens and Scopes → 看右下角显示的 languageId 值。
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 支持多语言：写成
["onLanguage:typescript", "onLanguage:javascript", "onLanguage:jsx"] - 若含自定义 language（如通过
grammars注册），必须用注册时声明的language字段值，而非文件后缀 - 避免过度宽泛：不用
"onStartupFinished"，它会拖慢启动速度且违背按需原则
什么时候该用 onCommand 而不是 onLanguage？
当插件核心能力是提供命令（如格式化、生成代码、调用 CLI），且不依赖文件上下文或语言服务时，onCommand 更精准、更轻量。
例如一个只做“复制当前文件路径”的插件，不需要监听文件打开，也不需要语言支持，硬配 onLanguage:* 反而导致无意义加载。
- 命令 ID 必须和
contributes.commands[].command完全一致，包括大小写和中划线 - 若命令由其他插件注册（如
vscode-eslint的eslint.executeAutofix），你无法用onCommand激活自己插件去监听它 - 用户首次执行命令时才激活，适合低频、高内聚功能，比如“一键部署到测试环境”
workspaceContains 和 onFileSystem 有什么实际区别？
workspaceContains 用于检测工作区根目录是否存在某类文件（如 package.json、tsconfig.json），适合项目级插件（如 ESLint、Prettier 配置探测）；onFileSystem 则针对 VSCode 内置文件系统方案（如 vscode-remote 连接远程时的 vscode-remote:// URI）。
-
workspaceContains不会匹配子目录，只查根目录；要覆盖多层结构，得列多个模式，如["package.json", "src/tsconfig.json"]（注意：后者实际无效，它只查根） -
onFileSystem:ssh表示插件需在 SSH 远程连接时激活，但若插件本身不处理远程协议（比如只是改主题），加这个反而增加启动开销 - 二者都属于“环境探测型”激活，适合做初始化检查，但不能替代语言或命令触发逻辑
最容易被忽略的是：插件一旦激活，其 activate() 函数只运行一次，后续所有事件（如打开新文件、切换标签页）都不会重新触发它。所以初始化逻辑里必须考虑状态复位、资源清理、事件监听器重复绑定等问题——这些不在 activationEvents 控制范围内，得靠代码自己兜底。
