VS Code插件开发需基于其扩展模型，用yo code初始化TypeScript项目，activate函数为唯一入口，命令注册须与package.json的contributes.commands严格匹配，读取文件应通过activeTextEditor而非fs，调试需正确配置launch.json指向Extension Host进程。
VS Code 插件开发不是“配个 package.json 就能跑”，核心在于理解其扩展模型——它基于 Node.js 运行，但所有 UI 和 API 调用都必须通过 VS Code 提供的 vscode 模块桥接，且主进程（Extension Host）与编辑器本身是隔离的。
怎么初始化一个可用的插件项目
别手写 package.json 和入口文件。VS Code 官方推荐用 yo code 脚手架，它会生成带调试配置、基础命令注册、tsconfig 的 TypeScript 项目（强烈建议用 TS，JS 里类型错位极难排查）：
npm install -g yo generator-code yo code
选 “New Extension (TypeScript)”，填完名字后，npm install 完就能 Ctrl+Shift+P → Developer: Launch Extension 启动调试。注意：生成的 extension.ts 里 activate 函数是插件唯一入口，所有注册逻辑（比如 vscode.commands.registerCommand）必须在这里完成，延迟注册会导致命令不可见。
为什么你的命令注册了却点不亮
常见原因不是代码写错，而是没在 package.json 的 contributes.commands 里声明，或声明的 command 字符串和 registerCommand 第一个参数不一致。VS Code 不会报错，只是静默忽略。
-
contributes.commands是用户可见的元信息（标题、图标），不声明 = 命令无法出现在命令面板 -
commands.registerCommand('myExt.sayHello', ...)中的'myExt.sayHello'必须和package.json里command字段完全匹配（包括大小写） - 如果想让命令支持右键菜单，还得额外配
contributes.menus，且when条件要合理（例如editorTextFocus表示当前编辑器有焦点）
如何安全读取/修改当前打开的文件内容
别直接用 Node.js 的 fs.readFile——它读的是磁盘文件，而 VS Code 缓存了未保存的编辑状态。正确方式是通过 vscode.window.activeTextEditor 获取编辑器实例，再调用 document.getText() 或 edit() 方法：
const editor = vscode.window.activeTextEditor;
if (editor) {
const text = editor.document.getText(); // 获取当前全部文本（含未保存改动）
await editor.edit(editBuilder => {
editBuilder.replace(editor.selection, 'replaced');
});
}
注意：editor.edit() 是异步的，且必须在 if (editor) 检查后调用；否则调试时可能因无活动编辑器而抛 Cannot read property 'edit' of undefined。
调试时断点不命中或控制台无输出
VS Code 插件运行在独立的 Extension Host 进程中，不是你 F5 启动的主窗口。调试配置必须指向 .vscode/launch.json 里的 “Launch Extension” 配置，且 runtimeExecutable 应为 ${execPath}（即当前 VS Code 可执行文件）。另外：
-
console.log输出默认出现在 “Debug Console”，不是浏览器开发者工具的 console - 如果用了
vscode.window.showInformationMessage等 UI 方法，它们只在被调试的子实例中生效，主 VS Code 窗口看不到 - TypeScript 编译后源码映射（source map）失效？检查
tsconfig.json是否启用了"sourceMap": true和"outDir": "./out"
插件开发最耗时间的往往不是功能实现，而是搞清哪些操作必须走 vscode API、哪些不能跨进程访问、以及调试路径是否真的连到了 Extension Host——这些边界比语法细节更容易卡住人。
