本文详解在 Node.js 环境中通过 CommonJS 模块系统跨文件共享变量的方法，重点解决因变量声明缺失导致 module.exports 失效的问题，并提供可运行示例与关键注意事项。
本文详解在 node.js 环境中通过 commonjs 模块系统跨文件共享变量的方法，重点解决因变量声明缺失导致 `module.exports` 失效的问题，并提供可运行示例与关键注意事项。
在 Node.js 项目中，常需将配置、常量或初始化数据从一个文件（如 config.js 或 constants.js）导出，并在其他文件中导入使用。但若导出失败，控制台既无输出也无报错，往往是因为变量未被正确声明——这是初学者最常见的陷阱之一。
✅ 正确做法：显式声明 + 显式导出
第一步：在 server.js 中正确声明并导出变量
// server.js const theVar = "testing123"; // ✅ 使用 const/let/var 显式声明 module.exports = theVar; // ✅ 导出该值（非全局隐式变量）
⚠️ 错误写法（会导致导出 undefined）：
theVar = "testing123"; // ❌ 未声明，创建的是全局属性（非模块作用域变量） module.exports = theVar; // ❌ 此时 theVar 在模块作用域内未定义，实际导出 undefined
第二步：在调用文件（如 app.js）中正确引入并使用
立即学习“Java免费学习笔记（深入）”；
// app.js
const theVar = require('./server.js'); // ✅ 路径需准确（注意 ./ 开头）
console.log(theVar); // ✅ 输出: "testing123"? 提示：
require()返回的是module.exports所赋的值，因此直接接收为常量即可，无需额外解构或属性访问。
? 注意事项与最佳实践
-
路径必须相对且有效：
require('../server.js')中的..表示上一级目录，确保路径与实际文件结构一致；推荐使用./显式标识当前目录起始。 -
仅限 Node.js 环境：
require和module.exports是 CommonJS 规范，浏览器环境不支持；前端应改用 ES 模块（import/export）。 -
避免隐式全局变量：省略
const/let/var会将变量挂载到global对象（Node）或window（浏览器），不仅污染作用域，更导致模块系统无法捕获该值。 - 导出即所用：若导出的是字符串、数字等原始值，导入后即为该值的副本；若导出对象或函数，则共享引用，修改会影响所有导入方。
✅ 验证是否生效的小技巧
在 app.js 末尾添加一行测试代码：
console.assert(typeof theVar === 'string' && theVar === 'testing123', '❌ Export failed!');
若控制台无任何输出，说明导入成功；若抛出断言错误，则需检查声明、路径或执行环境。
掌握这一基础机制，是构建可维护 Node.js 应用的关键一步——变量共享不是魔法，而是清晰声明与规范导出的必然结果。
