VSCode需通过插件或代码片段配合语言作用域实现语言专属模板：文件级模板用File Templates等插件，片段级模板需在snippets中正确配置scope（如"vue"而非".vue"），并确保语言ID匹配、JSON格式正确、prefix大小写一致。
怎么让 VSCode 插件自动插入语言专属模板
VSCode 本身不自带“按语言自动插入模板”功能，必须靠插件或用户代码片段配合语言作用域（scope）实现。关键不是装一堆插件，而是明确：你要的是「文件级模板」（新建 .py 文件时自动生成 class 结构），还是「片段级模板」（在已有文件里输 cls 按 Tab 插入类定义）。前者靠插件如 File Templates 或语言专属扩展（如 Python Extension Pack 中的文件生成器），后者靠 snippets 配置里的 scope 字段限定生效语言。
常见错误是把全局 snippet 当成语言模板用——比如在 javascript.json 里写了 vue 片段，结果在 .ts 文件里也弹出来。正确做法是：要么把片段写进对应语言的 JSON 文件（如 vue.json），要么在全局 snippet 里显式加 "scope": "vue"。
-
scope值必须是 VSCode 识别的语言 ID，不是文件后缀（vue✅，.vue❌；python✅，py❌） - 插件如
Doxygen Documentation Generator和DocumentThis不生成文件模板，只生成函数/类注释，别混用 - 新建文件时触发模板，得依赖插件的
template功能（如File Templates）或项目脚手架（如create-react-app），不是 snippets 能解决的
Vue / React / Python 文件模板怎么配才不踩坑
直接复制网上 Vue 模板到 vue.json 很容易失效，因为新版 Vetur 或 Vue 3 的语法结构变了。React 同理，create-react-app 生成的组件和 tsx 文件结构差异大，硬套旧 snippet 会漏 Props 类型或 useState 导入。
实操建议：先打开一个真实 .vue 或 .tsx 文件，观察编辑器左下角显示的语言模式（比如是 vue 还是 vue-html），再决定 snippet 放哪个文件；Python 模板要区分 python 和 py——VSCode 用的是 python，不是后缀名。
- Vue 模板中
${TM_FILENAME_BASE}在.vue文件里能取到文件名，但在<script setup></script>单文件组件里可能为空，建议改用${TM_FILENAME} - React TSX 模板若含
interface Props，body 里要写成"interface Props {", " $1", "}"，否则换行缩进错乱 - Python 模板慎用
${CURRENT_YEAR}：它返回四位数年份，但 PEP 257 要求版权年份用范围（如2024-2026），需手动拼接
为什么 prefix 输入后没反应
最常见原因是文件未被 VSCode 正确识别语言模式。比如你开了一个 index.js，但左下角显示的是 Plain Text，那无论你在 javascript.json 里配多少 prefix 都不会触发。另一个原因是 snippet 名称重复或 JSON 格式错误（比如多了一个逗号、少了个引号），VSCode 不报错，但整个文件 snippets 失效。
- 检查语言模式：看编辑器右下角，点击它可手动切换为正确语言 ID
- 验证 JSON：保存
javascript.json后，按Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools，看 Console 是否有 parsing error -
prefix区分大小写：Log和log是两个不同触发词，别写错 - 如果用了
scope，确保它和当前语言 ID 完全一致（查法：Ctrl+Shift+P→Developer: Inspect Editor Tokens and Scopes）
DocumentThis 和 Doxygen 插件生成注释的区别在哪
两者都生成注释块，但触发逻辑和适用场景完全不同。DocumentThis 是“光标所在位置智能推导”，支持 JS/TS/Python 等，输入 /** + Tab 就能生成带 @param、@returns 的 JSDoc；Doxygen Documentation Generator 是“基于符号上下文”，要求光标必须紧贴函数/类定义行上方，且只认 C/C++/Python 的 Doxygen 风格（@brief、@param），对 TypeScript 接口支持弱。
-
DocumentThis可以配置jsdoc.description等设置控制字段顺序，Doxygen插件的模板基本固定，改起来要动 JSON 配置 -
Doxygen的快捷键Alt+Shift+D在 Linux 上可能被桌面环境劫持，得去系统设置里关掉冲突快捷键 - 两者都不能处理嵌套函数或箭头函数的参数推导，遇到
const fn = (a, b) => {}会生成空@param，得手动补
真正难搞的是跨语言一致性——比如你团队用 TypeScript 写前端、Python 写后端，却要求统一用 Doxygen 风格注释。这时候得放弃自动推导，老老实实配两套 snippets，别指望一个插件通吃。
