要让自定义 snippet 触发时自动带括号并定位光标，需在 body 中使用 $1 占位符（如 "console.log($1);"），$1 为首个可编辑位置，$0 设最终光标点；确保 prefix 匹配语言模式、editor.snippetSuggestions 未设为 none，并注意 JSON 格式正确。
如何让自定义 snippet 触发时自动带括号
VS Code 的用户代码片段（user snippets）默认插入的是纯文本，不会主动加括号或跳转光标。想实现类似 console.log() 这种“输入 log → 按 Tab → 插入 console.log($1) 并把光标定位在 $1 处”，关键在于正确使用占位符和变量语法。
常见错误是直接写 "body": "console.log()"，结果插入后光标停在末尾，没法立刻填参数。应该用 $1 表示第一个可编辑位置，$0 表示最终光标停留点：
{
"log": {
"prefix": "log",
"body": ["console.log($1);"],
"description": "console.log with cursor in parentheses"
}
}
-
$1是首个 tab stop，按 Tab 可跳到下一个；多个$1、$2会顺序跳转 -
$0是最终光标位置，不参与跳转，适合放结尾分号或换行后的位置 - 如果 body 是数组，每项为一行；字符串则单行插入
- 别漏掉逗号，JSON 格式错误会导致整个 snippet 文件失效
为什么 prefix 输入后没出现在建议列表里
不是所有 snippet 都会在键入时自动弹出。VS Code 默认只对部分语言模式启用 snippet 建议，且受 editor.snippetSuggestions 和 editor.suggestOnTriggerCharacters 控制。
典型现象：你在 Python 文件里写了 py，但没看到自己定义的 pyprint 片段；或者只在 JavaScript 里生效，切换到 TypeScript 就没了。
- 确认当前文件右下角语言模式是否匹配 snippet 所属语言（比如
python.json只对.py或设为 Python 模式的文件生效） - 检查设置：
editor.snippetSuggestions必须不是none，推荐设为top或inline -
editor.suggestOnTriggerCharacters影响触发时机：设为true后，在.、/、"等字符后也会弹建议；但 prefix 匹配本身不依赖它 - 若想全局生效（如通用工具函数），可放在
javascript.json或typescript.json中，并确保对应语言扩展已启用
snippet 中怎么动态插入当前文件名、日期或选中文本
VS Code 支持内置变量，但不是所有变量都实时可用——有些只在特定上下文生效，比如选中文字时 $TM_SELECTED_TEXT 才有值，否则为空。
常用且稳定可用的变量包括：$TM_FILENAME_BASE（不含后缀的当前文件名）、$CURRENT_YEAR、$CURRENT_MONTH、$CURRENT_DATE。但注意：$CLIPBOARD 在某些系统（尤其是 macOS）上因沙盒限制可能读不到剪贴板内容。
- 插入当前时间戳：
"body": ["// Created at $CURRENT_YEAR-$CURRENT_MONTH-$CURRENT_DATE $CURRENT_HOUR:$CURRENT_MINUTE"] - 基于文件名生成类名：
"body": ["class ${TM_FILENAME_BASE/(.*)/${1:/pascalcase}/} {", "\t$0", "}"]（需配合正则转换） -
$1、$2是手动定义的 tab stop，不是变量；${1:default}可设默认值，回车后自动填充 - 正则替换语法仅在占位符内有效，如
${TM_FILENAME_BASE/(.*)/${1:/upcase}/}，不能用于整个 body 字符串
多人协作项目中 snippet 怎么同步且不冲突
用户级 snippet（通过 Preferences: Configure User Snippets 创建）存在本地路径，无法随项目 Git 提交；而工作区级 snippet 存在 .vscode/snippets/ 下，能被纳入版本控制，但需团队统一配置才能生效。
实际协作中容易踩的坑是：A 同学提交了 .vscode/snippets/python.json，B 同学打开项目却没看到效果——因为 VS Code 默认不加载工作区 snippet，除非显式启用。
- 必须在项目根目录
.vscode/settings.json中添加："editor.snippetSuggestions": "top"（或其它非 none 值） - 工作区 snippet 文件名需与语言 ID 严格匹配，比如 Python 对应
python.json，不是py.json或Python.json - 若同时存在用户级和工作区级同名 prefix，工作区级优先级更高；但不同语言文件中，各自 snippet 互不影响
- 避免在 snippet body 中硬编码绝对路径或机器相关配置（如本地 Python 解释器路径），否则别人拉取后可能报错
真正难调的不是写法，而是 snippet 的作用域判断逻辑——它不看文件内容，只认语言模式、设置开关、文件路径层级。一个看似正确的 JSON，可能就因为少了一个逗号、语言 ID 拼错、或 settings.json 里关掉了 suggestion，导致整组补全完全静默。调试时优先查状态栏语言模式和命令面板里运行 Developer: Toggle Developer Tools 看有没有 snippet 相关报错。
