vscode代码片段不生效的主因是scope字段错误、未执行developer: reload window重载、语言模式不匹配；需确认配置文件对应语言id（如tsx用javascriptreact.json）、json数组格式正确、body缩进统一用空格。
VSCode 的代码片段不是“配完就用”，必须明确作用域、重载窗口、验证语言模式，否则 prefix 输入后根本不会出现在补全列表里。
为什么输入 prefix 没反应？检查这三件事
最常见的情况是：写了 JSON，保存了，但输入 log 或 rfc 后毫无反应。这不是 VSCode 抽风，而是配置链断在某个环节：
- scope 字段缺失或写错 —— 比如在
typescript.json里配了"scope": "ts"，实际应填"typescript"；留空时只对全局片段生效，且需确认是否创建的是全局文件 - 没执行
Developer: Reload Window—— 仅保存 JSON 文件不触发重新加载，编辑器不会扫描新片段 - 语言模式不匹配 —— 当前文件右下角显示的是
Plain Text而非TypeScript，或 .tsx 文件被识别为JavaScript React，此时必须在javascriptreact.json中配置，而不是typescript.json
body 怎么写才不崩？数组格式 + 正确缩进是底线
body 必须是字符串数组，每行一项；单字符串或对象会解析失败，导致整个片段静默失效：
[
"function ${1:name}(${2:params}) {",
" $0",
"}"
]
常见错误包括：
- 用制表符（Tab）缩进 body 内容 —— VSCode 片段只认空格缩进，混用会导致 JSON 解析失败
- 漏掉逗号或引号 —— JSON 格式错误时 VSCode 不报错，只是跳过该片段
- 误写
$0多次 —— 只有第一个$0生效，后续的被忽略 - 想让占位符带默认值，却写成
$1:ComponentName—— 正确写法是${1:ComponentName}
如何让片段只在 .tsx 文件生效？选对配置文件比写逻辑更重要
React 函数组件模板在 .ts 文件里能触发，但在 .tsx 文件里不出现？大概率是配错了目标文件：
- 不要用
typescript.json—— 它只管 .ts，不管 .tsx - 不要用
javascript.json—— 它不识别 JSX 语法上下文 - 必须用
javascriptreact.json—— 这是 VSCode 对 .jsx/.tsx 文件的语言 ID 绑定，也是唯一能正确激活的配置文件 - 如果用 Remote-SSH 或 Dev Container，片段必须配置在远程环境的
javascriptreact.json里，本地配了也没用
变量和占位符怎么配合才实用？别堆功能，先保可用
内置变量像 ${TM_FILENAME_BASE}、${CURRENT_YEAR} 看着很酷，但容易因大小写或拼写错误失效。优先用稳妥组合：
- 命名组件时用
const ${1:ComponentName} = () => {，比硬塞${TM_FILENAME_BASE}更可控 - 包裹选中文本用
${SELECTION}，但必须先选中内容再触发片段，否则${SELECTION}展开为空 - 多处同步编辑靠多个
$1，比如interface ${1:Name} { name: string; } export type ${1:Name}Props = {};，改一次名字，两处自动同步 - 避免嵌套变量如
${${CURRENT_YEAR}}—— 不支持，直接当普通文本插入
真正卡住人的从来不是怎么写，而是 scope 写错、没重载、语言模式不匹配这三点。配完立刻在对应文件里输 prefix + Tab 测试，比反复检查 JSON 格式更高效。
