JSON配置文件核心是安全可靠地加载使用：须为合法JSON格式，推荐存于根目录或src/config/，禁放敏感信息；浏览器可用import或fetch加载，Node.js用fs读取；必须校验字段与类型并设默认值。
JavaScript 中 JSON 作为配置文件使用时，核心是把它当作纯数据载体——不是代码，不执行逻辑，只读取、校验、注入应用。关键不在“怎么解析”，而在“怎么安全、可靠、可维护地加载和使用”。
JSON 配置文件的基本写法与存放位置
配置文件本质是一个符合 JSON 格式的文本文件（如 config.json），内容必须是合法的 JSON：只能用双引号、不能有注释、末尾不能多逗号、值类型限于字符串、数字、布尔、null、数组、对象。
- 推荐放在项目根目录或
src/config/下，便于统一管理 - 开发时可用相对路径（如
./config.json），构建后需确保它被正确打包或部署为静态资源 - 避免把敏感信息（如 API 密钥）直接写在 JSON 里，尤其不要提交到 Git；可用环境变量 + 构建时替换替代
浏览器中加载 JSON 配置（现代方式）
ES 模块支持直接导入 JSON（需构建工具如 Vite/Webpack 启用 JSON 导入），最简洁：
import config from './config.json' assert { type: 'json' };
若不支持或需动态加载（比如根据环境切换配置），用 fetch：
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
立即学习“Java免费学习笔记（深入）”；
- 确保服务器返回
Content-Type: application/json - 加上错误处理，避免因网络失败或格式错误导致应用崩溃
- 示例：
async function loadConfig() {
try {
const res = await fetch('./config.json');
if (!res.ok) throw new Error(`HTTP ${res.status}`);
return await res.json();
} catch (err) {
console.error('加载配置失败:', err);
throw err;
}
}
Node.js 环境读取 JSON 配置
用 fs.readFileSync 或 fs.promises.readFile 读取文件，再用 JSON.parse() 解析：
- 同步读取适合启动时一次性加载（如 CLI 工具、服务端初始化）
- 异步读取更符合 Node 的非阻塞风格，尤其在配置较大或需按需加载时
- 务必捕获
JSON.parse抛出的语法错误，否则会直接崩掉进程
const fs = require('fs').promises;
async function loadConfig() {
try {
const data = await fs.readFile('./config.json', 'utf8');
return JSON.parse(data);
} catch (err) {
if (err instanceof SyntaxError) {
throw new Error('配置文件 JSON 格式错误：' + err.message);
}
throw err;
}
}
增强健壮性：校验与默认值
光解析不够——用户改错字段名、漏填必填项、填错类型，都会让程序出问题。建议加一层轻量校验：
- 用
in操作符或hasOwnProperty检查关键字段是否存在 - 对数值型字段用
typeof x === 'number' && isFinite(x)判断 - 提供合理默认值，避免
config.api.timeout是undefined导致请求挂起 - 简单例子：
function validateConfig(raw) {
const config = { timeout: 5000, baseUrl: 'https://api.example.com', ...raw };
if (!config.baseUrl || typeof config.baseUrl !== 'string') {
throw new Error('配置缺少或格式错误：baseUrl');
}
return config;
}
不复杂但容易忽略
JSON 配置本身很简单，真正决定成败的是加载时机、错误反馈、版本兼容性和变更管理。上线前跑一次 JSON.parse 校验脚本，比 runtime 报错更早发现问题。
