CommonJS模块 和 ECMAScript模块官方文档整理

1、commonjs

在node.js中，每个文件都被视为一个单独的模块。模块的局部变量是私有的，只有exports出去的变量，才能被外界访问。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

默认情况下，node.js会将以下情形视为 cjs模块:文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

• 扩展名为.cjs的文件；
• 扩展名为.js的文件，且离自己最近的package.json文件包含一个顶级字段“type”，其值为“commonjs”；
• 扩展名为.js的文件，且离自己最近的package.json文件不包含一个顶级字段“type”(建议明确指定 type值，而不是不定义)；
• 扩展名不为.mjs, .cjs, .json, .node, .js的文件，且离自己最近的package.json文件包含一个顶级字段“type”，其值为“module”，但是这些文件通过require引入。

调用require（）时，始终使用cjs模块加载器，
require采用同步方式加载，可以在代码的任意位置使用。
由于require（）的同步特性，无法使用它加载ECMAScript模块文件。尝试这样做将抛出ERR_REQUIRE_ESM错误。请改用import（）。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

要获取调用require（）时将加载的确切文件名，请使用require.resolve（）函数。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

1)、对于一个文件，导出的是对象的引用。如果内部的属性变化了，外部也会变化。
2)、对于再次引入同一个文件，如果文件名一模一样，则从缓存里面取
3)、还有种方式，要使模块多次执行代码，请导出函数并调用该函数。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

导出一个原始值文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

//child.js
var counter = 3;
function incCounter() {
  counter++;
}
module.exports = {
  counter: counter,
  incCounter: incCounter,
};

//parent.js
let child = require('./child.js')
console.log(child.counter);  // 3
child.incCounter();
console.log(child.counter); // 3没变

导出一个对象文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

//child.js
var obj = {
    counter:3
};
function incCounter() {
    obj.counter++;
}
module.exports = {
  obj: obj,
  incCounter: incCounter,
};
//parent.js
let child = require('./child.js')
console.log(child.obj.counter);  // 3
test.incCounter();
console.log(child.obj.counter); // 4 变了

导出一个对象，多个文件，会从缓存里获取文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

//child.js
var obj = {
    counter:3
};
function incCounter() {
    obj.counter++;
}
module.exports = {
  obj: obj,
  incCounter: incCounter,
};
//parent.js
let child = require('./child.js')
let child1 = require('./child.js')
console.log(child.obj.counter);  // 3
test.incCounter();
console.log(child.obj.counter); // 4 变了
console.log(child1.obj.counter); // 4 变了

如果require加载的是个文件夹，那么node.js默认会尝试加载 index.js 或者 index.node文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

动态导入

import() 既支持cjs，又支持 esm文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

import('./lib.js').then((res)=>{
    //res.default  
})

2、es module

调用 import（）时，始终使用esm模块加载器，文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

默认情况下，node.js会将以下情形视为 esm 模块:
扩展名为 .mjs 的文件；
扩展名为.js的文件，且离自己最近的package.json文件包含一个顶级字段“type”，其值为“module”；文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

1)、对于一个文件，导出的是对象的引用。如果内部的属性变化了，外部也会变化。
2)、对于再次引入同一个文件，如果文件名一模一样，则从缓存里面取。如果文件名加了query，则重新加载文件，不会缓存里取
3)、还有种方式，要使模块多次执行代码，请导出函数并调用该函数。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

单次导入，导入基本类型文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

//child.mjs
var counter = 3;
function incCounter() {
  counter++;
}
export default {
  counter: counter,
  incCounter: incCounter,
};

//index.mjs
import child from "./lib.mjs";
console.log(child.counter); // 3
child.incCounter();
console.log(child.counter); // 3没变

多次导入，导入引用类型文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

//child.mjs
var obj = {
  counter: 3,
};
function incCounter() {
  obj.counter++;
}
export default {
  obj: obj,
  incCounter: incCounter,
};

//index.mjs
import child from "./lib.mjs";
import child1 from "./lib.mjs";  //从缓存里面取
console.log(child.obj.counter); // 3
child.incCounter();
console.log(child.obj.counter); // 4变了

console.log(child1.obj.counter); // 4变了，拿的缓存里的

多次导入，避免缓存文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

//child.mjs
var obj = {
  counter: 3,
};
function incCounter() {
  obj.counter++;
}
export default {
  obj: obj,
  incCounter: incCounter,
};

//index.mjs
import child from "./lib.mjs?time=1";
import child1 from "./lib.mjs?time=2";  //增加query避免缓存
console.log(child.obj.counter); // 3
child.incCounter();
console.log(child.obj.counter); // 4变了
console.log(child1.obj.counter); // 3没变，重新加载的文件

import.meta.url

当前文件文件模块的 url地址。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

import { readFileSync } from 'node:fs';
const buffer = readFileSync(new URL('./data.proto', import.meta.url));

import.meta.resolve 实验功能文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

await import.meta.resolve('./dep', import.meta.url);
const dependencyAsset = await import.meta.resolve('component-lib/asset.css');

在esm中使用 require

import { createRequire } from 'node:module';  
const require = createRequire(import.meta.url);

// sibling-module.js is a CommonJS module.
const siblingModule = require('./sibling-module');

注意： 从node.js v16以后，使用node内置核心模块都采用node:xx， 比如 node:fs，它和fs的区别是，不能被require缓存，而fs能被缓存，可以查看 v16 changeLog-issue文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html

const path = require('node:path');  //不被缓存
const path = require('path');    //可以被缓存

3、esm模块与cjs模块之间的差异

• esm使用import/export， 而cjs使用require/exports
• cjs可以使用 __filename 或者 __dirname， 而esm不行，esm只能使用 import.meta.url
• esm不支持本机模块。 ith module.createRequire() or process.dlopen.
• cjs使用 require.resolve， 而esm使用new URL(), import.meta.resolve
• cjs可以通过环境变量指定的路径，去查找本机上对应位置的模块，而esm不行，
• cjs 是在运行时确定，而esm则在静态编译时确定。
• cjs可以同步执行，esm不行

共同点：模块导出的都是引用。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/gcs/27601.html