npm 的 package.json 簡介

描述

關(guān)于 package.json 文件中需要的內(nèi)容,您只需要了解這個文檔。
它必須是標準的JSON,而不是JavaScript對象字面量。

本文檔中描述的許多行為都受到npm-config中描述的配置設(shè)置的影響。

name

如果您計劃發(fā)布包,那么包中最重要的部分。json是名稱和版本字段,因為它們是必需的。名稱和版本一起構(gòu)成一個標識符,該標識符被認為是完全惟一的。對包的更改應(yīng)該與對版本的更改一起出現(xiàn)。如果不打算發(fā)布包,名稱和版本字段是可選的。
名字就是你的東西的名字。

規(guī)則

  • 名稱必須小于或等于214個字符。這包括作用域包的作用域。
  • 名稱不能以點或下劃線開頭。
  • 新包的名稱中不能有大寫字母。
  • 該名稱最終成為URL、命令行上的參數(shù)和文件夾名稱的一部分。因此,名稱不能包含任何非url安全字符。

小貼士

  • 不要使用與核心節(jié)點模塊相同的名稱。
  • 不要在名稱中使用“js”或“node”。假設(shè)它是js,因為您正在編寫一個包。json文件,您可以使用“engine”字段指定引擎。(見下文)。
  • 名稱可能會作為參數(shù)傳遞給require(),所以它應(yīng)該是簡短的,但也應(yīng)該是合理的描述性的。
  • 在過于依賴npm注冊表之前,您可能希望檢查npm注冊表,看看是否已經(jīng)有了這個名稱。https://www.npmjs.com/

名稱可以有選擇地用范圍作為前綴,例如@myorg/mypackage。有關(guān)詳細信息,請參見np -scope。

version

如果您計劃發(fā)布包,那么包中最重要的部分。json是名稱和版本字段,因為它們是必需的。名稱和版本一起構(gòu)成一個標識符,該標識符被認為是完全惟一的。對包的更改應(yīng)該與對版本的更改一起出現(xiàn)。如果不打算發(fā)布包,名稱和版本字段是可選的。

版本必須由node-semver解析,它與npm綁定為依賴項。(npm install semver to use it yourself.)

更多關(guān)于版本號和范圍的信息請訪問semver.

description

在里面放一段描述。它是一個字符串。這有助于人們發(fā)現(xiàn)你的包,因為它列在 npm search 結(jié)果里。

keywords

輸入關(guān)鍵詞。它是一個字符串數(shù)組。這有助于人們發(fā)現(xiàn)您的包,因為它列在npm search 結(jié)果里。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容