VSCode自定义代码补全核心靠user snippets，需通过命令面板创建全局或语言专属JSON文件，严格匹配语言ID、确保JSON格式正确、prefix完整输入后按Tab展开，不依赖插件或LSP配置。
VSCode 自定义代码补全，核心靠 user snippets，不是装插件、也不是调 LSP 参数——它不依赖语言服务器，不改 editor.suggestOnTriggerCharacters，只靠 JSON 配置就能生效。
怎么创建一个全局可用的 snippet
全局 snippet 对所有文件类型都起作用，适合补全通用缩写（如 log、key）或跨语言模板（如版权头）：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Snippets: Configure User Snippets - 选
New Global Snippets file，命名如common.json - 在打开的 JSON 文件中，直接写片段对象，例如：
{
"log template": {
"prefix": "log",
"body": ["console.log('$1', $2);", "$0"],
"description": "Insert console.log with cursor at message"
}
}
保存即刻生效，无需重启。注意：prefix 区分大小写，且必须完整输入后按 Tab 才展开；输入 lo 不会触发 log。
为什么在 Python 文件里写 main 没反应
常见错觉是“没配置成功”，实际更可能是：当前文件没被识别为 Python，或片段没放在 python.json 里：
- 检查右下角状态栏语言模式是否显示
Python，不是Plain Text或Auto - 如果只想在
.py文件中用main补全，必须把片段放进python.json（通过Snippets: Configure User Snippets→ 选python） - 片段内容要严格符合格式，比如双引号不能漏，
body是字符串数组或单字符串，$0必须存在才准确定位光标
正确示例：
{
"If __name__ == '__main__' block": {
"prefix": "main",
"body": ["if __name__ == \"__main__\":", " $0"],
"description": "Insert a main guard block"
}
}
editor.quickSuggestions 和 snippet 有什么关系
完全无关。snippet 属于「静态展开」机制，而 editor.quickSuggestions 控制的是「语义联想型建议」是否自动弹出（比如变量名、函数名、import 的模块）：
- 即使你把
"other": false，main+Tab依然能展开——因为这是显式触发，不走 quickSuggestions 流程 - 但如果你希望输入
main后自动下拉菜单里出现该 snippet 候选项（而非必须按 Tab），就得确保"other": true，且editor.snippetSuggestions没被设成"none" - 默认值是
"top"，所以只要 quickSuggestions 开着，snippet 就会出现在补全列表顶部
容易被忽略的细节：路径、作用域和换行
很多人配好 snippet 却发现不生效，问题常出在这些地方：
- 全局 snippet 存在
snippets/common.json，可通过Developer: Open User Data Folder定位，别手动生成错路径 -
scope字段不是万能开关：它只能限制「在哪些语言中显示该 snippet」，不能让 snippet 在非声明语言里意外生效（比如写了"scope": "javascript"，它就不会在 Python 文件里出现） -
body中换行必须用\n，不能直接回车；制表符用\t；$1、$2是跳转锚点，$0是最终光标位置，漏掉会导致光标卡住 - JSON 文件里不能有注释（VSCode 会报错），所有说明必须写在
description里
最稳妥的做法：每次改完保存后，新开一个对应类型的空文件测试，输入 prefix，看下拉菜单是否出现、按 Tab 是否正确展开、光标是否落到预期位置——别依赖记忆，实测最可靠。
