Node.js的包是一個目錄，其中包含JSON格式的包說明文件package.json。Node.js的包基本遵循CommonJS規(guī)范，因此具備以下特征：

CommonJS規(guī)范定義的包特性：

1）頂層目錄包含package.json文件；
2）bin目錄存放二進制文件；
3）lib目錄存放JavaScript文件；
4）doc目錄存放文檔；
5）test目錄存放單元測試。

Node.js的模塊與文件是一一對應的，文件不僅可以是JavaScript源碼文件或二進制文件，還可以是目錄。最簡單的包，就是一個目錄的模塊。

Node.js的包通常是一些模塊的集合，在模塊的基礎上提供了更高層的抽象，相當于提供了一些固定接口的函數(shù)庫。
通過定制package.json，我們可以創(chuàng)建更復雜、更完善、更符合規(guī)范的包用于發(fā)布。

Node.js在調(diào)用包時，首先會檢查包中的package.json文件的main字段，將其作為包的接口模塊，如果package.json文件的main字段不存在，那么Node.js會嘗試尋找index.js或index.node作為包的接口。

package.json文件是CommonJS規(guī)范用于描述包的文件，完全符合規(guī)范的package.json文件應該包含以下字段：
1）name：包名。包名是唯一的，由小寫字母、數(shù)字和下劃線組成，不能含空格。
2）description：包說明。對包進行簡要描述。
3）version：版本號。滿足《語義化版本識別》規(guī)范的版本字符串。
4）keywords：關(guān)鍵字數(shù)組，通常用于搜索。
5）maintainers：維護者數(shù)組。每個元素包含name、email(可選)、web(可選)字段。
6）contributors：貢獻者數(shù)組。格式與maintainer數(shù)組相同。包作者應該是貢獻者數(shù)組的第一個元素。
7）bugs：提交bug的地址，可以是網(wǎng)址或電郵地址。
8）licenses：許可證數(shù)組。每個元素要包含type(許可證名稱)和url(鏈接到許可證文本的地址)字段。
9）repositories：倉庫托管地址數(shù)組。每個元素要包含type(倉庫的類型，如Git)、url(倉庫地址)和path(相對于倉庫的路徑，可選)字段。
10）dependencies：包依賴。是一個關(guān)聯(lián)數(shù)組，由包名和版本號組成。

注：《語義化版本識別》規(guī)范是國外提出的一套版本命名規(guī)范，最初目的是解決各種各樣的版本號大小比較的問題，目前被許多包管理系統(tǒng)所采用。

下面是一個完全符合CommonJS規(guī)范的package.json例子：
代碼如下:
{
"name": "testpackage",
"description": "My package for CommonJS.",
"version": "0.1.0",
"keywords": [
"testpackage",
"liq"
],
"maintainers": [
{
"name": "liq",
"email": "liq@hotmail.com",
}
],
"contributors": [
{
"name": "liq",
"web": "http://blog.csdn.net/chszs"
}
],
"bugs": {
"mail": "liq@hotmail.com",
"web": "http://blog.csdn.net/chszs"
},
"licenses": [
{
"type": "Apache License v2",
"url": "http://www.apache.org/licenses/apache2.html"
}
],
"repositories": [
{
"type": "git",
"url": "http://github.com/chszs/packagetest.git"
}
],
"dependencies": {
"webkit": "1.2",
"ssl": {
"gnutls": ["1.0", "2.0"],
"openssl": "0.9.8"
}
}
}

聲明：本網(wǎng)頁內(nèi)容旨在傳播知識，若有侵權(quán)等問題請及時與本網(wǎng)聯(lián)系，我們將在第一時間刪除處理。TEL:177 7030 7066 E-MAIL:11247931@qq.com