最近使用 Npm 發(fā)布包時遇到了一些坑舌厨，集中記錄下以便后續(xù)查看忿薇。

01.

就個人經(jīng)驗來說，我們寫的包往哪兒發(fā)布揉燃，無非下面三個地方筋栋。其中淘寶鏡像倉庫每隔十分鐘會同步一下 Npm 倉庫的新模塊，所以實際要看的也就是往 Npm 倉庫和公司內(nèi)部搭建的私有 Npm 倉庫上如何發(fā)布包抢腐。搞不清楚他們的關(guān)系就會碰到一些欲罷不能的大坑肴颊。

• Npm 倉庫

  Npm 倉庫是一個公共平臺，所有人開發(fā)的模塊想要共享都可以扔上去授瘦，有人需要使用什么功能去上面找即可竟宋。缺點是服務器架設(shè)在國外，國內(nèi)下載包時速度比較慢徒欣。

• 淘寶鏡像倉庫

  淘寶鏡像倉庫由阿里云贊助蜗字，在國內(nèi)搭設(shè)的一套服務器脂新，每隔十分鐘從 Npm 倉庫上同步一下包粗梭，內(nèi)容可以認為和 Npm 倉庫是一樣的断医，所以國內(nèi)一般都會把下載倉庫地址設(shè)置為淘寶鏡像倉庫，這樣子下載包時會大大加快速度鉴嗤。

• 公司內(nèi)部私有 npm 倉庫

  有的公司內(nèi)部開發(fā)一些私有包不想上傳到公共平臺 Npm 倉庫醉锅，于是乎就搭建公司內(nèi)部的私有 Npm 倉庫，與 Npm 倉庫其實差不多男韧，只不過有一個是供全世界開發(fā)者使用的平臺默垄，一個是只供公司內(nèi)部使用的平臺。

02.

介紹下 npm 發(fā)布包的機制朦前。以 Npm 倉庫為例說明鹃操。

• 告訴 npm 你想往哪個倉庫發(fā)布包。

  往哪個倉庫發(fā)布包也叫做設(shè)置上傳/發(fā)布地址恩伺。這個過程記錄在 package.json 文件中椰拒。publishConfig 屬性就記錄著倉庫地址。我這里是 公司內(nèi)部搭建的私有 npm 倉庫褒脯，所以寫了一個內(nèi)部地址缆毁。如果是往 Npm 倉庫 發(fā)布包，該屬性可以省略不寫颁督。

  // package.json
  "publishConfig": {
      "registry": "http://localhost/repository/npm-hosted/"
   }
  

• 申請進入倉庫的權(quán)限。

  你要往指定倉庫發(fā)布包往核，比如往 Npm 倉庫 發(fā)布包嚷节，你得先登錄上這個倉庫虎锚，然后才能進行上傳。這是因為 Npm 倉庫得知道是誰進行了發(fā)布包這個動作效斑，并且還要判斷該用戶是否有權(quán)限進行發(fā)布包柱徙。這就好比你往一個倉庫運輸貨物护侮，得在大門口登記一下，標明身份不是羊初。如果你的賬戶名或密碼錯誤长赞，倉庫管理員肯定要攔住你，因為你不具備權(quán)限進行運輸貨物脯颜。

  那么怎么獲得進入倉庫的賬戶號呢贩据。以 Npm 倉庫為例，登錄 Npm 官網(wǎng)讼庇，在右上角有個 Sign up 按鈕近尚，點擊進行注冊。記錄下有用信息：賬戶名歼跟、密碼、郵箱留瞳。如果是公司內(nèi)部搭建的私有 Npm 倉庫骚秦，讓管理員給你一個賬戶密碼即可。

• 進入倉庫硬梁。

  就像往倉庫運輸貨物一樣胞得，有了進入倉庫的權(quán)限，那就先登錄進入倉庫跃巡，然后在進行貨物上架牧愁。

  $ npm login
  
  Username: xxxx
  Password:
  Email: (this IS public) xxxxx@qq.com
  Logged in as xxxx on https://registry.npmjs.org/.
  

  為了安全起見递宅，輸入密碼不會顯示任何東西，你只需輸入完成按回車即可烘绽，不用擔心自己是否沒有輸入上俐填。

  像上述代碼所示就是登錄成功的標志，并且最后一行可以看到我們是要往 https://registry.npmjs.org/ （Npm 倉庫）上發(fā)布包的盏檐。

  小tip:

  每次登錄都要手動輸入 賬戶驶悟、密碼、郵箱 這個步驟很是繁瑣硫豆，有個簡單的方法可以一步到位。以 賬戶: admin旨别，密碼:admin123 為例進行說明汗茄。

  打開百度洪碳，搜索 base64 關(guān)鍵字，隨便點開一個 base64 在線編碼/解碼 條目非迹，在新窗口左側(cè)/上測輸入 admin:admin123 （也即：賬戶:密碼 格式纯趋，中間有個英文格式的冒號）冷离，點擊編碼按鈕進行編碼得到編碼后的值 YWRtaW46YWRtaW4xMjM=西剥。打開 npm 配置文件 .npmrc 文件，默認路徑為：C:\Users\Administrator\.npmrc揪阿，修改內(nèi)部內(nèi)容如下咆畏。此后再進行 $ npm login 時會自動記住賬戶密碼，一路回車登錄即可溺健。

  _auth="YWRtaW46YWRtaW4xMjM="
  email=xxxx@qq.com
  

• 發(fā)布包钮蛛。

  前面一個步驟成功進入倉庫，接下來就進行貨物上架即發(fā)布包岭辣。

  切換到要發(fā)布那個包的根目錄下沦童，輸入以下指令等待即可。

  $ npm publish 
  

  這個過程可能是遇到問題最多的地方躏精。如果失敗了鹦肿，檢查 C:\Users\Administrator\.npmrc 文件。一般的使用 Npm 都會配置淘寶鏡像倉庫瞭吃，這樣我們在下載 npm 包時會大大提升速度涣旨。操作如下：

  $ npm config set registry https://registry.npm.taobao.org
  

  此時打開 .npmrc 文件會看到變化如下：

  _auth="YWRtaW46YWRtaW4xMjM="
  email=xxxx@qq.com
  registry=https://registry.npm.taobao.org
  

  由于我們這里是往 Npm 倉庫 發(fā)布包的霹陡，這里設(shè)置的下載地址是 淘寶鏡像倉庫，二者不一致會導致錯誤攒霹〗矗可先將最后一行代碼刪除掉，此時默認下載倉庫也是 Npm 倉庫抠刺。下載倉庫地址和上傳倉庫地址（前面提到的在 package.json 文件中設(shè)置的）保持一致才能發(fā)布包摘昌。發(fā)布完成后可以再設(shè)置下載倉庫為淘寶鏡像倉庫。

  往公司內(nèi)部私有 Npm 倉庫發(fā)布包也要注意這個問題买优，要保證下載倉庫和上傳倉庫都是 公司內(nèi)部的 Npm 倉庫挺举。當然湘纵，大多數(shù)私有倉庫都會設(shè)置代理地址，二者并不是一模一樣砌左，但是要知道都是內(nèi)部 Npm 倉庫即可。

• 更新包屁擅。

  更新包和發(fā)布包操作步驟類似产弹，唯一的區(qū)別是要修改下 package.json 中的 version 字段痰哨，你更新包，總得讓包的版本變化一下吧早抠。操作重復上面幾步步驟撬讽。

03.

總結(jié)：

• 下載地址。

  從哪個倉庫下載 npm 包咪奖，國內(nèi)一般選擇淘寶鏡像，為嘛趟佃？因為快呀闲昭。設(shè)置完成后可以在 npm 配置文件 C:\Users\Administrator\.npmrc 中進行查看。如果是從 Npm 倉庫 下載鸯绿，將 .npmrc 文件中 registry 那一行代碼刪掉即可簸淀。

  設(shè)置方式：

  $ npm config set registry https://registry.npm.taobao.org
  

• 上傳地址。

  自己開發(fā)一個 Node 模塊舷手，想往倉庫發(fā)布共享出去劲绪，上傳到哪個倉庫。如果是往 Npm 倉庫 上傳歉眷，該屬性可以不寫汗捡，默認上傳地址即為 Npm 倉庫。

  設(shè)置方式：

  // package.json
  "publishConfig": {
      "registry": "http://localhost/repository/npm-hosted/"
   }
  

• 發(fā)布和更新包要保證上傳地址和下載地址是同一個倉庫的地址庸追。