VS Code代码片段需按开发习惯定义、触发和维护，优先使用工作区snippets文件，注意prefix语义性、body变量标记、语言模式匹配、原生动态变量支持及Git协作规范。
VS Code 的代码片段（Snippets）不是“写了就能用”的快捷键，它需要你按实际开发习惯去定义、触发、维护——否则很容易变成闲置功能。
如何创建一个能真正用上的自定义代码片段
别从全局 snippet.json 开始，先用当前工作区的 .vscode/snippets/javascript.json（或对应语言名）写。这样避免污染其他项目，也方便 Git 跟踪。
关键点：
-
prefix要短且有语义，比如log比consolelog更快敲，useq比useQueryHook更适合日常触发 -
body里用$1、$2标记光标跳转位置，$0是最终退出点；别堆砌所有参数，只暴露常变项（比如 React 组件名、API 路径） - 用
${1:default}提供默认值，减少回车后手动删改 - 如果 body 含换行和缩进，注意 JSON 字符串里要转义
\n和\t，更推荐用 VS Code 内置的「Configure User Snippets」图形界面生成初稿
为什么 typedoc 注释 + useState 组合片段总不生效
常见现象：输入 us 没触发、或者触发了但插入的是旧版本内容。原因通常是语言模式不匹配或作用域冲突。
检查这几处：
- 当前文件右下角显示的语言模式是否正确？
us片段若定义在typescript.json里，在.js文件中不会激活 - 有没有同名的全局 snippet 覆盖了工作区 snippet？优先级是：当前文件夹 > 用户设置 > 全局内置
- 片段中用了
"scope": "javascript,typescript"，但没加到package.json的contributes.snippets里——这仅对扩展有效，普通用户 snippet 不支持 scope 字段
如何让 snippet 支持动态值（比如时间戳、文件名、选中文本）
VS Code 原生支持少量变量，不需要插件：
-
$TM_FILENAME_BASE插入当前文件名（不含后缀） -
$CURRENT_YEAR-$CURRENT_MONTH-$CURRENT_DATE生成日期字符串 -
$SELECTED_TEXT把你高亮选中的内容原样插入（适合包裹操作，如加console.log($SELECTED_TEXT)） -
$CLIPBOARD粘贴剪贴板内容（慎用，可能含不可见字符）
注意：这些变量只在 body 中生效，不能用于 prefix 或 description；也不支持函数调用或计算逻辑，比如不能写 ${Date.now()}。
多人协作时怎么同步常用 snippet
直接把 .vscode/snippets/ 目录提交到 Git 即可。但要注意：
- 不同人编辑同一个 language.json 文件容易冲突，建议按功能拆分：比如
react-hooks.json、api-client.json - 避免在 snippet 里硬编码路径或用户名（如
/Users/xxx/project），改用相对路径变量或留空由使用者补全 - 团队内统一命名风格，比如所有 prefix 都小写+短横线：
fc-component、swr-fetch，别混用驼峰和下划线
最常被忽略的一点：snippet 不会自动重载。修改后必须重启 VS Code 或执行命令 Developer: Reload Window，否则新内容不生效。
