VSCode插件生成工程级代码结构的关键在于贴合真实项目约束。需通过注册命令获取光标上下文，精准提取语义信息；用TextEdit替换而非插入以保缩进与语法正确；支持单/多文件联动生成；依赖workspace级配置与路径自动识别，确保生产可用。
VSCode插件能直接在编辑器内生成工程级代码结构，比如新建 React 组件、Python Flask 路由、TypeScript 接口定义，甚至整套微服务模块骨架——关键不在“能不能”，而在“怎么让生成逻辑贴合真实项目约束”。
注册命令 + 获取光标上下文是所有自动生成的起点
用户触发生成动作（如右键菜单或快捷键），本质是执行一个 vscode.commands.registerCommand；但真正决定生成内容的，是当前光标所在位置的语义信息。
- 用
vscode.window.activeTextEditor?.selection拿到选区，避免无意义全文件覆盖 - 用
vscode.window.activeTextEditor?.document.lineAt(position).text提取当前行，判断是否在src/pages/下、是否已有export default、是否有@Component装饰器等上下文信号 - 不要硬编码路径字符串，改用
vscode.workspace.getConfiguration('myGenerator').get('templateRoot')让用户可配置模板位置
模板注入必须处理变量替换与缩进对齐
直接把模板字符串 .replace() 插入文档，大概率导致缩进错乱、JSX 标签换行异常、TS 类型声明断行失败——因为 VSCode 的 TextEdit 默认按纯文本插入，不感知语言语法。
- 用
vscode.TextEdit.replace(range, content)替代editor.insert()，确保替换范围精准 - 对多行模板，先调用
vscode.languages.setTextDocumentLanguage(document, 'typescript')显式指定语言，再用vscode.languages.formatTextDocument(document, { tabSize: 2 })触发格式化（需提前在package.json的contributes.languages中声明支持） - 变量占位符统一用
${name}格式，而非{{name}}或$name，避免和 ESLint / Prettier 的插值规则冲突
生成逻辑要区分“单文件”和“多文件联动”场景
生成一个组件文件容易，但生成 index.ts 导出、__tests__/ 测试桩、stories/ Storybook 配置，就涉及跨文件操作和写入顺序依赖。
- 单文件生成：用
vscode.workspace.openTextDocument()+vscode.window.showTextDocument()即可 - 多文件生成：必须用
vscode.workspace.applyEdit()批量提交，否则用户看到的是“一个文件弹出、另一个文件卡住”的割裂体验 - 注意文件系统权限：Windows 下若目标目录不存在，
fs.mkdirSync(path, { recursive: true })必须加recursive: true，否则报ENOENT - 生成后自动打开主文件（如
MyComponent.vue），但别强行聚焦测试文件——用户大概率不需要立刻编辑它
用户配置项必须收敛到 workspace 级别，不能只读 user 设置
团队共用一套生成规则时，vscode.workspace.getConfiguration() 返回的配置优先级必须高于 vscode.workspace.getConfiguration().inspect() 查到的 user 级默认值，否则每个成员都要手动配一遍。
- 在
package.json的contributes.configuration中明确定义 schema，例如："myGenerator.componentPrefix"类型为string，默认值"Base" - 读取时用
config.get('componentPrefix', 'Base')，不建议用config.get('componentPrefix') || 'Base'，空字符串会被当作有效值 - 如果用户在
.vscode/settings.json里写了"myGenerator.skipTests": true，插件必须尊重该设置，而不是仅看全局配置
真正难的不是写出第一个 console.log('Generated!')，而是当用户在 monorepo 的 packages/ui 下新建组件时，插件能自动识别 pnpm 工作区结构、跳过 node_modules、按 packages/ui/src/components/ 路径生成，并把导出语句追加到最近的 index.ts 末尾——这些细节没被显式声明，却决定了插件到底算“玩具”还是“生产工具”。
