应使用 vscode.window.activetexteditor?.insertsnippet 生成符合项目规范的代码框架，避免硬编码样式、缩进错乱等问题，并通过 onlanguage 或 oncommand 精准激活插件，调用 formatdocument 兼容 prettier/eslint，模板路径须用 vscode.uri.joinpath 安全读取。
怎么让插件自动插入带样式的代码框架
直接往编辑器里写纯 HTML 或 JSX 没用，用户看到的是编辑区的源码，不是渲染结果。真正起作用的“样式”得靠 VS Code 自身的语法高亮、主题配色，或者通过 vscode.previewHtml（已弃用）/ Webview 渲染独立视图。但绝大多数场景下，你只需要生成结构清晰、符合团队规范的代码块，并确保它能被 Prettier / ESLint 正确处理。
常见错误现象：editor.insertSnippet 插入后缩进错乱、注释格式不统一、CSS 类名硬编码导致后期难维护。
- 优先用
vscode.window.activeTextEditor?.insertSnippet，而非editor.edit手动拼字符串——前者自动适配当前语言模式和缩进设置 - 模板中避免写死颜色值或字体尺寸；用语义化类名（如
btn-primary），把样式交给项目已有的 CSS-in-JS 或 SCSS 系统 - 如果生成的是 Vue/React 组件，记得在模板字符串里保留
${}占位符，由插件运行时动态填入组件名、props 等，而不是静态字符串
为什么 package.json 里的 activationEvents 决定插件是否“卡顿”
插件一启动就加载全部逻辑，会拖慢 VS Code 启动速度。VS Code 要求你声明“什么条件下才激活”，否则可能被标记为“低性能插件”。
典型错误配置："activationEvents": ["*"] —— 这会让插件在任何文件打开时都初始化，哪怕用户只是看个 JSON 配置。
- 按需激活：比如只在
.ts文件里生成代码框架，就写"onLanguage:typescript" - 命令触发最安全：用
"onCommand:my-extension.generate-frame"，用户不点就不加载 - 多个条件可叠加，但别滥用
onStartupFinished，它仍会提前加载，仅适合必须全局监听的场景
如何让生成的代码兼容 Prettier 和 ESLint 规则
生成的代码被标红或格式错乱，不是插件问题，是模板没对齐项目已有规则。Prettier 不关心逻辑，只管空格/换行/引号；ESLint 则检查变量命名、禁止 console.log 等。
最容易被忽略的点：模板里写的 const foo = 'bar' 可能触发 quotes 规则报错，而项目要求双引号。
- 读取用户当前工作区的
.prettierrc和.eslintrc.js配置不现实，也不推荐——插件不该越权读配置文件 - 正确做法：模板本身用“中性写法”，比如所有字符串用单引号，函数用箭头函数，对象属性不换行；让 Prettier 启动后自动修正
- 关键动作：在插入前调用
vscode.commands.executeCommand('editor.action.formatDocument')，但要加await并捕获异常（用户可能没装 Prettier）
自定义模板路径怎么设才不会找不到文件
插件打包后，fs.readFileSync('./templates/button.tsx') 会失败——因为 vsix 里路径变了，且 Node.js 的 __dirname 在 Webview 环境下不可靠。
错误现象：Cannot find module './templates/xxx' 或生成内容为空。
- 一律用
vscode.Uri.joinPath(context.extensionUri, 'templates', 'button.tsx')获取资源路径 - 读取必须用
vscode.workspace.fs.readFile(uri)（返回Uint8Array），再转成字符串，不能用fs模块 - 模板文件要显式声明在
package.json的extensionKind和files字段里，否则打包时被忽略
vscode.window.showQuickPick 在 1.85 版本返回 undefined 而不是 null，就会让模板选择逻辑意外跳过。这类细节没有文档专门列出来，只能靠真实环境反复验证。
