在 node.js commonjs 中可用 require() 同步加载本地 json 文件,如 const config = require('./config.json');需确保扩展名为 .json、路径正确、语法严格且编码为 utf-8,结果自动解析并缓存。

在 Node.js 的 CommonJS 环境中加载本地 JSON 配置文件非常直接,不需要额外解析或异步处理,因为 require() 原生支持 .json 文件。
只需要确保:
- 文件扩展名是
.json(如config.json) - 文件路径正确且可访问
- 项目运行在 CommonJS 模式下(默认行为,无需特殊配置)
直接用 require() 加载
const config = require('./config.json');
console.log(config.appTitle); // 示例:输出 "我的应用"
Node.js 在模块加载过程中会自动识别 .json 后缀,读取文件内容、调用 JSON.parse(),并返回解析后的 JavaScript 对象。整个过程同步完成,无需 fs.readFile 或 fetch。
注意:路径必须是相对路径(以 ./ 或 ../ 开头)或绝对路径;不能只写 require('config.json'),否则会去 node_modules 中查找。
常见注意事项
- JSON 文件必须符合严格语法:双引号包裹键和字符串值,不能有尾逗号,不能有注释
- 文件编码应为 UTF-8(无 BOM)
- 如果 JSON 文件里有环境变量占位符(如
${PORT}),require()不会做替换,需自行处理 -
require()结果会被缓存——同一文件多次require返回的是同一个对象引用
配合 package.json 使用
你也可以把配置信息直接写在 package.json 中,然后通过:
const pkg = require('./package.json');
console.log(pkg.version);
这也属于 CommonJS 下的标准用法,原理相同。
不复杂但容易忽略。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











