原文：Using ES modules natively in Node.js

作者：Axel Rauschmayer

從版本 8.5.0 開始，Node.js 開始支持原生 ES 模塊，可以通過命令行選項打開該功能。新功能很大程度上得歸功于 Bradley Farias。

1.演示

這個示例的代碼目錄結(jié)構(gòu)如下：

esm-demo/
    lib.mjs
    main.mjs

lib.mjs：

export function add(x, y) {
    return x + y;
}

main.mjs：

import {add} from './lib.mjs';

console.log('Result: '+add(2, 3));

運行演示：

$ node --experimental-modules main.mjs
Result: 5

2.清單：需要注意的事情

ES 模塊：

• 不能動態(tài)導入模塊。但是 動態(tài) import() 的相關(guān)工作正在進行中，應(yīng)該很快就能提供支持。

• 沒有元變量，如 __dirname 和 __filename。但是，有一個的類似功能的提案：“import.meta”。看起來可能是這樣：

console.log(import.meta.url);

• 現(xiàn)在所有模塊標識符都是 URL（這部分在 Node.js 是新增的）：
  • 文件 - 帶文件擴展名的相對路徑： ../util/tools.mjs
  • 庫 - 沒有文件擴展名，也沒有路徑 lodash
  • 如何更好地使 npm 庫在瀏覽器中也可用（不使用 bundler）仍有待觀察。一種可能性是引入 RequireJS 風格的配置數(shù)據(jù)，將路徑映射到實際路徑。目前，在瀏覽器中使用 bare path 的模塊標識符是非法的。

與 CJS 模塊的互操作性

• 你可以導入 CJS 模塊，但它們總是只有默認的導出 - 即 module.exports 的值。讓 CJS 模塊支持命名導出已經(jīng)在做了，但可能需要一段時間。如果你能幫忙，可以來做。

import fs1 from 'fs';
console.log(Object.keys(fs1).length); // 86

import * as fs2 from 'fs';
console.log(Object.keys(fs2)); // ['default']

• 不能在 ES 模塊中使用 require()。主要原因是：
  • 路徑解析工作稍有不同：ESM 不支持 NODE_PATH 和 require.extensions。而且，它的標識符始終是 URL 也會導致一些細微差異。
  • ES 模塊始終以異步方式加載，這確保了與 Web 的最大兼容性。這種加載風格并不能通過 require() 混合使用同步加載 CJS 模塊。
  • 禁止同步模塊加載也可以為 Top-level await 導入 ES 模塊保留后路（一個當前正在考慮的功能）。

3.早期版本的 Node.js 上的 ES 模塊

如果要在 8.5.0 之前的 Node.js 版本上使用 ES 模塊，請參閱 John-David Dalton 的 @std/esm。

提示：如果不啟用任何可解鎖的額外功能，將在 Node.js 保持 100％ 兼容原生 ES 模塊.

FAQ

什么時候可以不帶命令行選項使用ES 模塊？

目前的計劃是在 Node.js 10 LTS 中默認可使用 ES 模塊。

進一步閱讀

有關(guān) Node.js 和瀏覽器中 ES 模塊的更多信息：

• “Making transpiled ES modules more spec-compliant” [using ES modules natively vs. transpiling them via Babel]
• “Module specifiers: what’s new with ES modules?” [Why .mjs? How are module specifiers resolved? Etc.]
• “Modules” [in-depth chapter on ES modules in “Exploring ES6”]

即將到來的 ECMAScript 提案：

• 博客: “ES proposal: import() – dynamically importing ES modules”
• 提案: “import.meta”