vscode代码片段“配完就生效”：需确保json合法、prefix不冲突、文件路径正确，通过快捷键ctrl+shift+p（win/linux）或cmd+shift+p（macos）打开preferences: configure user snippets选择对应语言文件（如javascript.json、typescriptreact.json或global.code-snippets），body必须为字符串数组，占位符用$1/$2或${1:default}，避免语法错误与prefix冲突。
直接能用的代码片段，不是“写完再试”，而是“配完就生效”——只要 JSON 格式合法、prefix 不冲突、文件保存在正确路径，输入触发词立刻补全。
怎么打开并选择正确的片段文件
别从菜单里一层层点“文件 > 首选项 > 用户片段”，容易选错范围。最稳的方式是快捷键 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Preferences: Configure User Snippets 回车，然后从弹出列表里选：
-
javascript.json：只在.js和.jsx文件里生效（推荐给 JS 项目） -
typescriptreact.json：专用于.tsx文件，避免和纯 TS 片段打架 -
global.code-snippets：全局可用，但慎用——log这种短前缀一旦被其他语言占用，就会互相覆盖
选错文件类型，比如把 React 片段写进 javascript.json，在 .tsx 里根本不会触发。
body 里写多行代码要注意什么
body 必须是字符串数组，每行代码一个元素，不能拼成单个字符串。否则换行丢失、缩进错乱、光标跳转失效。
- ✅ 正确：
"body": ["function $1() {", " $2", "}"] - ❌ 错误：
"body": ["function $1() {\n $2\n}"]（JSON 不认\n，会当普通字符插入）
占位符 $1、$2 是真实光标停靠点，不是占位文本；要用默认值就写 ${1:defaultValue}。如果漏掉 $ 符号，比如写成 1，VSCode 就当普通数字处理，不会跳转。
常见冲突和调试方法
输完 log 没反应？或者弹出多个同名片段？先确认三件事：
- 当前文件后缀是否匹配你写的
scope（如果有）或目标语言文件名（如typescriptreact.json只对.tsx生效） - 有没有其他扩展也注册了相同
prefix？比如 ESLint 或 Prettier 插件自带的片段 - JSON 文件里有没有语法错误？多一个逗号、少一个引号，整个文件就静默失效——VSCode 不报错，只当没配置
临时验证是否加载成功：在目标文件中输入 prefix，看智能提示里是否出现你的片段名和 description。不出现，基本就是路径或格式问题。
真正卡住的地方往往不是语法多难，而是 body 数组换行写错、prefix 被语言内置片段劫持、或者 JSON 里藏了个不可见的 Unicode 字符。配好之后别急着写业务，先在空文件里敲两下试试。
