如何自定义VSCode代码片段的用户代码块配置教程？

本文共计959个文字，预计阅读时间需要4分钟。

别手动建+vscode/snippets/+目录或更改路径。VS Code只认命令面板入口生成的文件，且对文件扩展名和命名规则有严格要求：

• 全局通用片段：执行 Preferences: Configure User Snippets → 选 New Global Snippets file → 文件名必须以 .code-snippets 结尾（如 common.code-snippets）
• 语言专属片段：同样进该命令 → 直接选 javascript 或 python → VS Code 自动创建并打开 javascript.json 或 python.json，文件名必须和语言 ID 完全一致（typescriptreact.json 不是 tsx.json）
• 工作区级片段不能靠“新建文件夹”实现：需在项目根目录下手动建 .vscode/snippets/javascript.json，但必须先确保 .vscode 是隐藏目录且路径无拼写错误

body 必须是字符串数组，不是单个字符串

这是静默失效最常见原因。VS Code 解析 body 字段时，只接受 string[] 类型，哪怕只有一行也得包成数组。