快捷導(dǎo)航

Node.js中的CommonJS模塊化規(guī)范詳解

更新時間：2023年02月06日 09:09:25 作者：昆吾kw

這篇文章主要介紹了Node.js中的CommonJS模塊化規(guī)范,本文主要介紹了?CommonJS?規(guī)范在?Node?中的簡單應(yīng)用，主要就是導(dǎo)入和導(dǎo)出模塊，需要的朋友可以參考下

nodeJS的介紹

NodeJS不但自己可以完成服務(wù)器軟件的功能，也不再需要php，asp，jsp等傳統(tǒng)的服務(wù)器語言
nodeJS可以解析JS代碼，而沒有瀏覽器安全級別的限制，因?yàn)?，它的運(yùn)行可以脫離瀏覽器的環(huán)境，而是在服務(wù)端運(yùn)行；提供了很多系統(tǒng)級別的API，如：
文件的讀寫
進(jìn)程的管理
網(wǎng)絡(luò)通信
NodeJS的包管理器npm，成為世界上最大的開放源代碼的生態(tài)系統(tǒng)。

CommonJS

上文提到了 Node 采用的模塊化規(guī)范是 CommonJS，它主要規(guī)定了如何定義模塊，如果導(dǎo)出模塊和如何導(dǎo)入模塊：

定義模塊：一個文件就是一個模塊
導(dǎo)出模塊：通過 module.exports 導(dǎo)出模塊
導(dǎo)入模塊：通過 require 方法導(dǎo)入模塊

為了方便使用模塊化，于是提供了幾個全局的方法或?qū)ο?，分別是：

require：是一個方法，用來導(dǎo)入模塊
module：是一個對象，表示當(dāng)前的模塊定義
exports：是 module.exports 對象的別名，存放了模塊要導(dǎo)出的內(nèi)容
__dirname：獲取當(dāng)前文件的絕對路徑
__filename：獲取當(dāng)前文件絕對路徑和文件名稱

下面來看下這幾個對象和方法的使用。

模塊的導(dǎo)入和導(dǎo)出

首先準(zhǔn)備一個目錄：

a.js 模塊導(dǎo)出內(nèi)容：

const name = 'kw'

// 導(dǎo)出內(nèi)容有幾種不同的方式：
// 方式1：模塊只導(dǎo)出變量 name
module.exports = name
// 方式2：模塊導(dǎo)出的是一個對象，包含一個 name 屬性
module.exports.name = name
// 等同于
exports.name = name

模塊要導(dǎo)出的內(nèi)容是存放在 module.exports 中的，默認(rèn)是一個空對象。

exports 是module.exports 的別名，在導(dǎo)出內(nèi)容時，切不可這樣做：

const name = 'kw'

exports = name

這里就是值類型與引用類型的區(qū)別的問題。將 exports 指向一個全新的值，就和原來的 module.exports 斷了聯(lián)系，此時模塊將導(dǎo)出默認(rèn)的空對象。

在 idnex.js中，導(dǎo)入 a 模塊：

const a = require('./a')
// 方式1的結(jié)果：
console.log(a) // 'kw'

// 方式2的結(jié)果：
console.log(a) // {name: 'kw'}

模塊不止 .js

上面的示例中，我們所創(chuàng)建的模塊都是一個個的 .js 文件，這屬于文件類型的模塊。

文件不止一種類型，文件模塊也就不止一種。在 node 中的文件模塊有三種：

后綴名為 .js 的文件
后綴名 .json 的 json 文件
后綴名為 .node 的經(jīng)過編譯的二進(jìn)制模塊文件

對不同文件后綴的模塊有不同的加載策略。對于 json 文件會調(diào)用 fs 模塊讀取后再用 JSON.parse 方法轉(zhuǎn)成 json對象；對于 .node 文件，不經(jīng)任何處理，直接調(diào)用。

我們知道 Webpack 是一個模塊打包工具，它默認(rèn)支持 CommonJS 規(guī)范。使用 Webpack 時，也會認(rèn)為一個文件就是一個模塊。但比 CommonJS 規(guī)范更加豐富的是，不僅 .js 、.json 是模塊，任意一個文件都是模塊，比如 .png，.vue，.ts，但是這種模塊 Webpack 是“不認(rèn)識”的，還需要安裝對應(yīng)的 loader 去解析。

require 導(dǎo)入模塊的查找機(jī)制

按照來源劃分，在 Node 中一共有三類模塊，分別是：

內(nèi)置模塊：也叫核心模塊，由 Node 本身實(shí)現(xiàn)和提供的，比如 fs、http、path模塊
自定義模塊：一般項(xiàng)目中自己寫的每一個 .js 文件都是
第三方模塊：通過包管理工具 npm/yarn/pnpm 安裝到 node_modules 目錄下的模塊

require 方法在導(dǎo)入模塊時，會有一個查找的機(jī)制。

導(dǎo)入內(nèi)置模塊

參數(shù)是一個模塊名。如果發(fā)現(xiàn)是內(nèi)置模塊，則導(dǎo)入并結(jié)束查找。

const http = require('http')

導(dǎo)入自定義模塊

參數(shù)是一個文件路徑，以 ./ 、../ 或者 /開頭。

// 此時會當(dāng)作內(nèi)置模塊查找，自然是找不到的，會報錯
const a = require('a.js')

// 必須以 ./、 ../、 / 開頭
// 找到同級目錄下的 a.js 并導(dǎo)入
const a = require('./a.js')

如果模塊沒有帶后綴：

const a = require('./a')

會依次去找有沒有 a.js、 a.json、a.node，找到則導(dǎo)入模塊；沒有的話，會將 a 當(dāng)作一個目錄名，去找 a 目錄下的 index.js、 index.json、 index.node，找到則導(dǎo)入模塊。如果還沒有找到，則報錯找不到模塊。

導(dǎo)入第三方模塊

參數(shù)是一個模塊名，并且不是核心模塊名。

通過包管理工具安裝一個模塊：

npm install dayjs

// src/index.js

// 發(fā)現(xiàn) dayjs 不是內(nèi)置模塊，首先會從當(dāng)前模塊所在目錄的 node_modules 目錄下查找，找到后就結(jié)束查找。找不到則向上一級目錄查找，一直到系統(tǒng)的根目錄。
// 查找順序分別是：
/** 
    'c:\Users\taylo\Desktop\commonjs\src\node_modules',
    'c:\Users\taylo\Desktop\2022 掘金日新計劃 8月\commonjs\node_modules',
    'c:\Users\taylo\Desktop\2022 掘金日新計劃 8月\node_modules',
    'c:\Users\taylo\Desktop\node_modules',
    'c:\Users\taylo\node_modules',
    'c:\Users\node_modules',
    'c:\node_modules'
    在我們的目錄結(jié)構(gòu)中，會從第二個路徑中找到，于是導(dǎo)入模塊，結(jié)束查找。
*/

const dayjs = require('dayjs')

console.log(dayjs(123456789123).format('YYYY-MM-DD hh:mm:ss')) // '1973-11-30 05:33:09'