代码国的模块奇遇记

在遥远的代码王国里，有一位年轻的程序员骑士叫作 Node，他天赋异禀，能让 JavaScript 操作整个系统！他不像兄弟 JavaScript 只能在浏览器中施展魔法，他能控制文件、路径，甚至打开电脑上的任何资源。

一天，Node 骑士在冒险途中，遇到了两个掌管模块魔法的法师：老派的 CommonJS 大师 和 新生代的 ESModule 魔导师。

他们都掌握了分享魔法（模块导入导出），但风格迥异，经常争论：

---

📜 模块魔法的四大分歧：

1. 改名术不同

   • CommonJS 大师说：“我用 exports.xxx = xxx 的方式，不改名。”
   • ESModule 魔导师优雅地说：“我用 export {xxx as yyy}，随意更名。”

2. 懒惰命名法则

   • CommonJS 大师喜欢偷懒：“导入时 .js 扩展名可以省略！”
   • ESModule 魔导师坚持规范：“.mjs 是我的标识，不能省略！”

3. 自由咒语位置

   • CommonJS 随性地把 require() 写进任何一个 if 语句块中。
   • 而 ESModule 魔导师严肃地说：“import 是仪式，必须在顶层！”

4. 动态召唤术

   • CommonJS 可以通过 require(variable) 动态拼路径。
   • ESModule 虽不能动态拼，但他修炼了异步魔法：import('模块路径') —— 可异步动态召唤模块！

---

🧰 神器 NPM

在他们的旅途中，Node 骑士得到了一个强力工具 —— NPM 神器，它可以召唤世界各地的模块精灵：

• 使用 npm install，它会根据 package.json 把所有盟友召集起来；
• 如果你加上 --save，它会将召唤记入家谱（dependencies）；
• 想召唤一个能在终端战斗的神器？用 npm install -g 把它安装在全球魔法库；
• 若你不想污染全局魔法，可以在package.json 的 scripts 中写下命令，使用 npm run 命令名 激活。

---

📦 魔法读取术

有一日，Node 骑士要打开一本叫 corpus/data.json 的古籍。他不能直接翻开，因为他用了 ESModule 魔法体系。

于是他施展了以下法术：

import { readFileSync } from 'fs';
import { fileURLToPath } from 'url';
import { dirname, resolve } from 'path';

const url = import.meta.url;  // 获取当前魔法脚本的位置
const path = resolve(dirname(fileURLToPath(url)), 'corpus/data.json');
const data = readFileSync(path, { encoding: 'utf-8' });
console.log(data);

这个法术的流程是这样的：

1. import.meta.url 是他魔法书的精确定位符；
2. 他用 fileURLToPath() 把书本地址转成实体路径；
3. 用 dirname() 得到当前魔法书所在的目录；
4. 再用 resolve() 找到古籍的准确位置；
5. 最后，readFileSync() 读出内容，解开了隐藏的秘密！

---

💡旁白提示：如果这位骑士用的是 CommonJS 魔法，那他就可以轻松地用 __dirname 直接找到当前目录，根本不用 fileURLToPath！

const path = resolve(__dirname, 'corpus/data.json');

---

就这样，Node 骑士在模块之路上越走越远，成为连接前端与后端世界的桥梁。他的故事也在代码国代代流传。

---