VS Code files.associations 怎样让自定义后缀识别为 JSON

如果项目里有 .config、.rules 这类自定义后缀，VS Code 可能把它当成纯文本打开，既没有 JSON 语法高亮，也没有括号匹配和格式化提示。解决方法是给文件模式配置语言关联，而不是每次打开文件后临时切换语言。

本文只处理一个任务：让自定义后缀持久识别为 JSON。官方产品地址：https://code.visualstudio.com/。相关说明地址：https://code.visualstudio.com/docs/languages/overview。下面的界面图是原创静态说明图，不是 VS Code 截图。

核心配置是 files.associations：左侧写文件名或 glob 模式，右侧写语言标识 json。把它放到工作区设置后，同一项目里的成员打开对应文件就能得到一致的语言模式。

先确认临时切换和持久关联的区别

先打开一个待处理的自定义文件，例如 custom.config。如果右下角显示的是 Plain Text，点击状态栏的语言模式可以临时改成 JSON，但这个动作只影响当前编辑器状态；关闭文件后，VS Code 仍可能按原来的文件名规则重新识别。

要让后缀长期生效，需要使用 Configure File Association for 入口，或者直接编辑用户设置、工作区设置中的 files.associations。本教程使用工作区设置，因为它只影响当前项目，不会把一个项目的规则带到所有目录。

从 Language Mode 入口配置文件关联

在项目窗口中打开 custom.config，点击右下角的 Plain Text 或当前语言名称，选择 Configure File Association for。随后选择或输入 JSON 作为目标语言。这个入口的作用是把当前文件的匹配关系写进设置，而不是只改变当前标签页。

操作后先观察设置编辑器是否打开。如果没有看到设置文件，先确认窗口打开的是项目文件夹，而不是只打开了一个孤立文件；工作区作用域需要一个可识别的项目根目录。

在工作区 settings.json 中写入模式

也可以按 Cmd/Ctrl+Shift+P 打开命令面板，执行 Preferences: Open Workspace Settings (JSON)，手动写入映射。下面的配置会把项目内所有以 .config 结尾的文件交给 JSON 语言模式处理。

{
  // 只在当前工作区把自定义配置文件交给 JSON 语言模式
  "files.associations": {
    "*.config": "json",
    "*.rules": "json"
  }
}

左侧模式使用 glob 语法：*.config 匹配文件名后缀，settings.config 可以只匹配一个具体文件名；如果要按目录匹配，可使用带路径的模式。右侧必须填写 VS Code 认识的语言标识，JSON 的标识是小写 json，不要把显示名称误写成 JSON。

如果项目只需要关联一个后缀，保留一条映射即可。规则越具体，后续排查越容易；不要为了“保险”同时写多个覆盖同一文件的模式。

确认设置作用域和语言标识

保存设置后回到 custom.config，观察右下角是否显示 JSON。如果仍显示 Plain Text，重新打开文件或执行 Developer: Reload Window 可以排除窗口尚未刷新，但这只是刷新动作，不是替代配置的办法。

确认时看三个位置：工作区 .vscode/settings.json 是否保存了映射；当前文件名是否真的符合左侧模式；状态栏语言名称是否变为 JSON。三处一致，说明配置链路已经闭合。

文件关联不生效时按四项排查

1. 检查作用域：确认修改的是 Workspace Settings，而不是另一个用户设置文件；项目规则应落在当前项目的 .vscode/settings.json。
2. 检查模式：确认文件名符合 *.config 或具体 glob。模式匹配的是文件名或完整路径，不要把普通正则表达式直接写进去。
3. 检查大小写：语言标识按精确值匹配，JSON 使用 json；文件扩展名和具体文件名也要注意实际大小写。
4. 检查覆盖关系：如果用户设置和工作区设置都配置了同一模式，先删除重复项，再重新打开文件，避免误判到底是哪一条规则生效。

还可以点击状态栏语言名称，使用 Change Language Mode 查看当前文件实际处于什么模式。如果手动选 JSON 后能正常工作，但重新打开又恢复纯文本，通常说明持久化的 files.associations 没有写到当前工作区或模式没有匹配到文件名。

速查表

相关问题

只改状态栏里的 JSON 够不够吗？

不够。状态栏切换主要解决当前文件，想让同一后缀以后自动识别，需要保存 files.associations 规则。

工作区设置和用户设置应该选哪一个？

只服务当前项目的后缀规则放工作区设置；多个项目都要使用的通用规则才考虑用户设置。

为什么写成 JSON 后仍没有补全？

先确认语言模式真的变成 JSON，再区分语法模式与 Schema 补全。本文只负责文件关联，不负责为 JSON 文件配置 Schema。