Node.js中如何使用ES6导入语法

# Node.js中如何使用ES6导入语法

## 引言

随着ECMAScript 6（ES6）的普及，JavaScript的模块系统从传统的CommonJS逐渐向ES Modules（ESM）过渡。Node.js作为主流的JavaScript运行时环境，从v12开始逐步支持ES6模块系统。本文将详细介绍在Node.js中使用ES6导入语法的各种方法和注意事项。

---

## 一、Node.js模块系统的发展

### 1.1 CommonJS的统治时期
Node.js最初采用CommonJS规范：
```javascript
// 导入
const fs = require('fs')

// 导出
module.exports = { ... }

1.2 ES Modules的引入

ES6标准提出的模块系统：

// 导入
import fs from 'fs'

// 导出
export default { ... }

Node.js从以下版本开始支持ESM： - v12：实验性支持 - v14：稳定支持 - v16+：成为LTS标准功能

---

二、启用ES6模块的三种方式

2.1 使用.mjs扩展名

将文件保存为.mjs后缀：

// app.mjs
import { readFile } from 'fs/promises'

执行命令：

node app.mjs

2.2 设置package.json

在package.json中添加：

{
  "type": "module"
}

2.3 运行时参数

使用--input-type=module参数：

node --input-type=module -e "import fs from 'fs'; console.log(fs.existsSync('index.js'))"

---

三、基础导入语法详解

3.1 默认导入

import fs from 'fs'

3.2 命名导入

import { readFile, writeFile } from 'fs/promises'

3.3 混合导入

import fs, { readFileSync } from 'fs'

3.4 重命名导入

import { promises as fsPromises } from 'fs'

3.5 动态导入

const module = await import('./module.js')

---

四、与CommonJS的互操作性

4.1 在ESM中导入CJS模块

// esm.mjs
import cjs from './cjs.cjs'

4.2 注意事项

1. CJS模块的module.exports会转为ESM的默认导出
2. 不支持命名导入：

   
   import { named } from 'cjs-module' // 错误
   

4.3 在CJS中导入ESM（需要动态导入）

// cjs.cjs
const esm = await import('./esm.mjs')

---

五、路径解析的特殊处理

5.1 文件扩展名必须完整

import './module.js'  // 必须
import './module'     // 错误

5.2 目录索引文件

import './utils/index.js'  // 需要显式指定

5.3 新的URL解析

import fs from 'node:fs'  // 核心模块前缀
import data from './data.json' assert { type: 'json' }  // JSON导入

---

六、实际应用示例

6.1 现代Web框架中的使用

// server.mjs
import express from 'express'
const app = express()

app.get('/', (req, res) => {
  res.send('Hello ESM!')
})

app.listen(3000)

6.2 前端组件开发

// Button.mjs
export default class Button {
  constructor(text) {
    this.text = text
  }
  render() {
    return `<button>${this.text}</button>`
  }
}

6.3 工具链配置

// rollup.config.mjs
import { terser } from 'rollup-plugin-terser'

export default {
  input: 'src/index.js',
  plugins: [terser()]
}

---

七、常见问题与解决方案

7.1 __dirname不可用

替代方案：

import { fileURLToPath } from 'url'
import { dirname } from 'path'

const __filename = fileURLToPath(import.meta.url)
const __dirname = dirname(__filename)

7.2 第三方模块兼容性

解决方案： 1. 检查模块是否支持ESM 2. 使用兼容层：

   import _ from 'lodash-es'  // ESM版本

7.3 性能考量

• ESM是静态分析，加载效率更高
• 但启动时解析可能稍慢于CJS

---

八、迁移策略建议

1. 渐进式迁移：

   • 从新文件开始使用.mjs
   • 逐步改造旧文件

2. 双模式发布：

   {
    "exports": {
      "require": "./cjs/index.js",
      "import": "./esm/index.js"
    }
   }
   

3. 工具辅助：

   • 使用Babel转换
   • 通过TypeScript编译

---

结语

Node.js对ES6模块的支持标志着JavaScript生态的重要进化。虽然过渡期间可能会遇到兼容性问题，但ESM带来的静态分析、浏览器兼容等优势使其成为未来的发展方向。建议新项目直接采用ESM规范，现有项目可以制定渐进式迁移计划。

注意：本文基于Node.js 18 LTS版本编写，不同版本可能存在细微差异。 “`