vscode中require('./config.json')报错的根本原因是javascript语言服务默认不解析json模块,需在jsconfig.json或tsconfig.json中配置"resolvejsonmodule": true和"esmoduleinterop": true,并重启ts服务器。

VSCode 里 require('./config.json') 报错找不到文件
不是 Node.js 本身不支持 JSON,而是 VSCode 的 JavaScript 语言服务默认不解析 JSON 模块——它只把 .js 和 .mjs 当作可导入模块,.json 文件被忽略,导致跳转失效、补全缺失、甚至类型提示报错。
根本解决方式是告诉语言服务:“这个项目允许 JSON 导入”。关键在 jsconfig.json(JS 项目)或 tsconfig.json(TS 项目)里加配置:
-
"resolveJsonModule": true—— 启用 JSON 模块解析(TS 项目必需;JS 项目中 VSCode 会识别该字段并启用对应逻辑) -
"esModuleInterop": true—— 避免require('./x.json')和import x from './x.json'混用时报错 - 必须存在
compilerOptions块,哪怕其他字段为空
示例 jsconfig.json:
{
"compilerOptions": {
"resolveJsonModule": true,
"esModuleInterop": true
},
"include": ["**/*.js"]
}
import JSON 时提示 “Cannot find module”
这是 TypeScript 编译器(或 VSCode 调用的 TS 服务)的报错,和运行时无关。Node.js 14.13+ 原生支持 import JSON(需 package.json 中含 "type": "module"),但 VSCode 的静态检查仍依赖配置。
除了上面的 jsconfig.json/tsconfig.json 配置,还需确认:
- 文件扩展名必须显式写出:
import data from './config.json',不能省略.json - 如果项目是 CommonJS(即没有
"type": "module"),则只能用require('./config.json');强行import会触发 TS 报错且运行时报ERR_UNSUPPORTED_ESM_URL_SCHEME - VSCode 左下角状态栏检查当前语言模式是否为 “JavaScript” 或 “TypeScript”——若误设为 “JSON”,编辑器会禁用所有 JS/TS 特性
JSON 文件里写注释后 require 失败
Node.js 原生 require('./x.json') 不支持注释,遇到 // 或 /* */ 直接抛 SyntaxError: Unexpected token /。这不是 VSCode 的问题,是运行时限制。
使用 JSON Schema 验证 JSON 数据,从示例 JSON 生成 schema,并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
绕过方法只有两个:
- 改用
fs.readFileSync('./x.json', 'utf8')+JSON.parse(),自己处理注释(例如用strip-json-comments包) - 把配置改成
.js文件导出对象(如module.exports = { port: 3000 };),天然支持注释和逻辑
注意:import 方式同样不接受带注释的 JSON——ES 规范不允许,任何运行时都一样。
修改配置后补全/跳转仍不生效
VSCode 不会自动重载 jsconfig.json 或 tsconfig.json 的变更。常见表现:改完配置,重启编辑器仍无法跳转到 JSON 文件。
必须手动触发语言服务重载:
- 按
Cmd+Shift+P(macOS)或Ctrl+Shift+P(Windows/Linux) - 输入
Developer: Restart TS Server并回车 - 等待右下角提示 “TypeScript server restarted”
如果项目根目录下同时存在 jsconfig.json 和 tsconfig.json,优先读取 tsconfig.json;删掉其中一个避免冲突。
JSON 模块支持本质是语言服务与运行时的双重契约:VSCode 需要配置来提供智能提示,Node.js 需要版本和模块类型匹配才能执行。两者缺一不可,且各自报错机制完全不同——看到错误先看左下角语言模式和终端运行结果,再决定该调配置还是该改代码。










