在 macos 上配置 vs code 代码片段需正确使用命令、存放位置和 json 格式:全局片段放 common.code-snippets,语言专属片段用 javascript.json 等;必含 prefix 和 body 字段,保存后需执行 developer: reload window 才生效。
在 macos 上配置 vs code 代码片段,核心是用对命令、放对位置、写对格式。全局片段适合 log、header 这类通用模板;语言专属片段更适合 react 组件、python 类这种语法强相关的结构。改完记得重载窗口,否则不生效。
打开并创建代码片段文件
按 Cmd + Shift + P 打开命令面板,输入 Configure User Snippets 并回车。然后选择:
-
New Global Snippets file:输入文件名如
common.code-snippets,适用于所有语言 -
javascript 或 python 等具体语言:会生成
javascript.json或python.json,只在对应语言中触发
VS Code 会自动在正确路径下创建文件(macOS 是 $HOME/Library/Application Support/Code/User/snippets/),不用手动找目录。
写对 JSON 格式和关键字段
片段内容是标准 JSON(不支持注释),每个片段必须包含 prefix 和 body,推荐加上 description。示例:
{
"log": {
"prefix": "log",
"body": ["console.log('${1:data}', $2);", "$0"],
"description": "插入 console.log"
}
}
-
prefix必须全小写,且不能含空格或特殊字符 -
body是字符串数组,每行一个元素;$1、$2表示跳转位,$0是最终光标位置 - 想跨语言生效,别加
"scope": "javascript";若只用于 JS/TS/Vue,可写"scope": "javascript,typescript,vue"
让片段即时生效
保存文件后,VS Code 不会自动刷新片段列表。需要手动执行一次:
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流:PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景:(1) "安装我的自动化服务",(2) "部署所有 Automato...
- 再按 Cmd + Shift + P
- 输入 Developer: Reload Window 并回车
之后在任意 .js 文件里输入 log 再按 Tab,就能看到提示并插入模板。
验证当前语言 ID 避免匹配失败
有时敲了 prefix 却没反应,大概率是语言模式不匹配。右下角状态栏显示的是当前语言 ID(比如 vue 而不是 .vue 文件名)。要确认真实 ID:
- 按 Cmd + Shift + P → 输入 Developer: Inspect Editor Tokens and Scopes
- 看顶部显示的
languageId,比如typescriptreact或vue - 在 snippet 中对应设置
"scope": "typescriptreact,vue"或直接删掉scope字段
不复杂但容易忽略










