npm publish 全方位解讀

本文參考了NPM中文文檔寫做而成的

npm publish 功能

發佈軟件包

npm publish 使用

npm publish [<tarball>|<folder>][--tag <tag>] [--access <public|restricted>][--otp otpcode] [--dry-run]

Publishes '.' if no argument supplied
Sets tag 'latest' if no --tag specified

npm publish 說明

將程序包發佈到註冊表，以便按名稱安裝。若是不存在本地文件。

gitignore 或 .npmignore 文件，則包括軟件包目錄中的全部文件。

若是兩個文件都存在，而且一個文件被（.gitignore 但不被）忽略， .npmignore 則將其包括在內。

有關 npm-developers 發佈的軟件包中包含的內容的詳細信息，以及有關如何構建該軟件包的詳細信息，請參見 。

默認狀況下，npm 將發佈到公共註冊表。能夠經過指定其餘默認註冊表或 npm-scope 在名稱中使用 a 來覆蓋它（請參閱參考資料 package.json）。

• <folder>：包含 package.json 文件的文件夾
• <tarball>：壓縮後的 tar 存檔的 url 或文件路徑，其中包含單個文件夾，其中包含 package.json 文件。
• [--tag <tag>] 使用給定標籤註冊發佈的軟件包，例如npm install @將安裝此版本。默認狀況下，npm publish更新和npm install安裝latest標籤。有關標籤的詳細信息，請參見npm-dist-tag。
• [--access <public|restricted>] 告訴註冊表此軟件包是應公開發行仍是受限制發行。僅適用於做用域包，默認爲 restricted。若是您沒有付費賬戶，則必須使用發佈與 --access public 發佈有範圍的軟件包。
• [--otp <otpcode>] 若是您在 auth-and-writes 模式下啓用了雙重身份驗證，那麼您能夠爲此提供來自身份驗證器的代碼。若是您不包括此文件，而您正在從 TTY 中運行，則會提示您。
• [--dry-run] 從開始 npm@6，除了實際發佈到註冊表外，全部發布均可以完成。報告將要發佈的內容的詳細信息。
• 若是指定的註冊表中已經存在軟件包名稱和版本組合，則失敗。

一旦使用給定的名稱和版本發佈了軟件包，即便使用 npm-unpublish 將其刪除，該特定名稱和版本組合也將永遠沒法再次使用。

從發佈開始 npm@5，tar1 的 sha1sum 和完整性字段具備 sha512sum 的都將在發佈期間提交給註冊表。隨後的安裝將使用受支持最強的算法來驗證下載。

相似於 --dry-runsee npm-pack，它找出要包含的文件並將它們打包到 tarball 中以上載到註冊表。

本文參考NPM中文文檔