Nodejs ES Modules 迁移指南

以下是Node.js ES Modules（ESM）迁移指南：

一、背景

随着JavaScript模块化的发展，ESM逐渐成为标准。迁移至ESM可提升代码的模块化和可维护性。

二、迁移步骤

1. 修改package.json

   添加"type": "module"，以告知Node.js使用ESM加载器。

   {
     "type": "module"
   }
   

2. 转换导入导出语法

   将CommonJS（CJS）的require()和module.exports转换为ESM的import和export。

   // CJS
   const fs = require('fs');
   module.exports = {
     readFile: fs.readFile
   };
   
   // ESM
   import fs from 'node:fs';
   export const readFile = fs.readFile;
   

3. 更新文件路径

   使用完整的文件路径和扩展名进行导入。

   import readFile from './readFile.js';
   

4. 调整TypeScript配置

   若使用TypeScript，需更新tsconfig.json，设置module为"es2020"或更高版本。

   {
     "compilerOptions": {
       "module": "es2020"
     }
   }
   

三、注意事项

1. 确保Node.js版本支持ESM。
2. 测试迁移后的代码，确保功能正常。

通过以上步骤，可将Node.js项目成功迁移至ESM，享受模块化带来的优势。