ES6 模块不支持运行时修改 export，但可通过对象封装 + 动态 import() 实现环境化配置覆盖，无需 Babel 转译。
es6 模块不支持运行时修改 `export`，但可通过对象封装 + 动态 `import()` 实现环境化配置覆盖，无需 babel 转译。
在纯 ESM（ECMAScript Module）环境中，无法像 CommonJS 那样通过 module.exports 动态覆写已声明的 export —— 因为 ESM 的导出是静态绑定、不可变的（immutable bindings）。但我们可以巧妙绕过这一限制：将所有配置项聚合到一个可变对象中，再通过动态导入（await import()）按需合并环境专属配置。
✅ 推荐方案：单对象导出 + 动态环境合并
核心思路是：
- 所有配置统一挂载到一个普通对象（如
Config）上； - 利用
import.meta.resolve()安全解析模块路径； - 使用顶层
await（ESM 支持）动态加载环境配置模块； - 用
Object.entries()遍历并浅合并覆盖属性； - 最终统一导出该对象（同时支持命名导出与默认导出）。
? 文件结构示例
├── Config.js # 主配置 + 环境合并逻辑 ├── Dev.Config.js # 开发环境覆盖项 ├── main.js # 消费端代码 └── package.json # 必须含 "type": "module"
? Dev.Config.js
export const Config = {
DatabaseHosts: ["localhost"],
DatabasePort: 5500,
};
export default Config;
⚙️ Config.js（关键实现）
// 主配置对象（可被后续覆盖）
const Config = {
DatabaseName: "myDbName",
DatabasePort: 3000,
DatabaseHosts: ["174.292.292.32"],
MaxWebRequest: 50,
MaxImageRequests: 50,
WebRequestTimeout: 30,
};
// 动态加载环境配置（仅在顶层作用域使用 await）
try {
const resolvedPath = await import.meta.resolve(`./${process.env.NODE_ENV}.Config.js`);
const { default: envConfig } = await import(resolvedPath);
// 浅合并：envConfig 中的同名属性将覆盖 Config 原值
for (const [key, value] of Object.entries(envConfig)) {
if (Object.hasOwn(Config, key)) {
Config[key] = value;
} else {
console.warn(`[Config] Ignoring unknown override key: ${key}`);
}
}
} catch (err) {
console.log(`⚠️ Config override skipped: ${err.message}`);
}
// 同时支持两种导入方式：
// import { Config } from './Config.js'
// import Config from './Config.js'
export { Config };
export default Config;
? main.js（消费端）
import Config from "./Config.js";
console.log("DatabaseHosts:", Config.DatabaseHosts); // 开发环境 → ["localhost"]
console.log("DatabasePort:", Config.DatabasePort); // 开发环境 → 5500
⚠️ 注意事项与最佳实践
-
必须启用 ESM：
package.json中需明确设置"type": "module"； -
Node.js 版本要求：动态
import()和import.meta.resolve()需 Node.js ≥ v18.18.0（推荐 v20+）； -
环境变量安全：
process.env.NODE_ENV在 ESM 中可用（Node.js 默认提供），但生产构建时建议通过--env-file或构建工具注入； -
覆盖粒度控制：当前为浅合并（shallow merge），若需嵌套对象深度合并，请引入
lodash.merge或自行实现； -
错误防御：
try...catch确保缺失环境配置文件不会中断主模块加载； - Tree-shaking 友好：因配置集中于单个对象，仍可被现代打包器（如 Vite/Rollup）有效分析和摇树。
此方案完全符合 ESM 规范，零 transpile，语义清晰，且易于扩展为多环境（如 Staging.Config.js、Test.Config.js），是构建现代化 Node.js/前端配置系统的稳健实践。
