對於一個項目,常用的一些npm簡單命令包含的功能有:初始化一個文件夾( npm init ),下載npm模塊( npm install ),創建測試( npm test ) 和自定義腳本( npm run )。但是,進一步了解一些 npm 的使用技巧可以徹底改變你的日常開發任務。
npm 文檔 和 CLI 命令行文檔 是非常不錯地的學習資料,但需要通過浏覽器訪問,這並不是很方便。因而可以通過命令行快速獲取所有可選項:
npm help
此外,還能獲取特定 npm 命令的使用幫助:
npm help <command>
例如:npm help install
另一種方式是通過下面的命令:
npm <command> -h
npm 通過bash提供了命令自動完成功能(包括 Bash for Windows 10 ):
npm completion >> ~/.bashrc //or Z shell npm completion >> ~/.zshrc
重新加載shell配置文件:
source ~/.bashrc
現在,在終端注入 npm ins
,然後按下 tab
鍵就會出現 install
了,不會再浪費時間去全部輸入了。
當你試圖安裝全部模塊時,類 Linux 系統可能會拋出權限錯誤,可以在npm命令之前添加 sudo
來執行,但這是一個較危險的選擇。一個更高的解決方式是改變 npm 默認的模塊安裝目錄:
mkdir ~/.npm-global npm config set prefix '~/.npm-global'
使用適當的文本編輯器將下面的一行添加到 ~/.bashrc
或者 ~/.zshrc
文件中:
export PATH="$HOME/.npm-global/bin:$PATH"
重新加載配置文件(source ~/.bashrc
),然後重新安裝npm到用戶所屬路徑:
npm install -g npm
這也會更新npm。
你可以通過下面的命令顯示npm當前的版本:
npm -v
如果有需要,可以通過下面的命令更新npm:
npm install -g npm
當 Node 的主版本 released 之後,你也可能需要重新構建 C++ 擴展:
npm rebuild
如果你需要管理多個版本的node.js和npm,可以考慮使用 n 或者 nvm。這有一篇關於 nvm 的文章:使用 nvm 安裝多版本的Node.js
使用 npm init
初始化一個新的項目,這會提示你關於項目的更多細節,並創建一個 package.json
文件。
如果你厭倦了每次開始一個新的項目都需要重新輸入同樣的信息,可以使用 -y
標記表示你能接受package.json
文件的一堆默認值:
npm init -y
或者你可以設置一些語義化的默認值:
npm config set init.author.name <name> npm config set init.author.email <email>
到目前為止,npm上已經有超過350000個模塊了,並且每天還在持續增長。盡管有很多非常棒的模塊,但是你還是想避免使用一些不受歡迎的、存在bug的或者無人維護的模塊。在 npmjs 和 Github 上搜索npm模塊是很實用但這還有一些其它選擇:
npms
npms 根據一個基於項目版本、模塊下載次數、最新更新日期、提交頻率、測試覆蓋率、文檔、貢獻者數量、issues數、star數、forks數和作者在社區的地位的綜合測量分數進行模塊排名。
npm Discover
npm Discover 定位於快速搜索和其它模塊通常一起使用的模塊,如 body-parser 通常和Express一起使用。
Packages by PageRank
Packages by PageRank 按照模塊的谷歌排名進行搜索和排序。
Curated npm Lists
還一個選擇就是利用別人的搜索結果。當需要一個健壯的解決方案時,我經常會參考 sindresorhus 的Awesome Node.js。
你已經安裝了一些模塊,看看都有啥:
npm list
(ls
、la
& ll
可以用作 list
的別名)
該命令會顯示所有模塊:(安裝的)模塊,子模塊以及子模塊的子模塊等。可以限制輸出的模塊層級:
npm list --depth=0
打開一個模塊的主頁:
npm home <package>
這只有在你的系統能打開浏覽器時有用–在服務端的系統上會失敗。同樣,可以打開一個模塊的 Github 倉庫:
npm repo <package>
或者它的文檔:
npm docs <package>
或者它目前的bugs列表:
npm bugs <package>
npm list
會顯示和你已經安裝地模塊的關聯模塊—這些沒有在 package.json
文件中被引用。你可以單獨npm uninstall
每一個模塊或者全部移除它們:
npm prune
如果安裝模塊時你添加了 --production
標記或者 NODE_ENV
被設置成 production
,package.json
文件中被指定為 devDependencies
的模塊也會被移除。
默認情況下,當用 --save/-S
或者 --save-dev/-D
安裝一個模塊時,npm 通過脫字符(^)來限定所安裝模塊的主版本號。例如,當運行 npm update
時, ^1.5.1
允許安裝版本號大於 1.5.1
但小於 2.0.0
版本的模塊。
波浪號(~)字符是限定模塊的次要版本。例如,當運行 npm update
時, ~1.5.1
允許安裝版本號大於 1.5.1
但小於 1.6.0
版本的模塊。可以將需要安裝的模塊版本前綴默認設置成波浪號(~):
npm config set save-prefix="~"
對於那些偏執的認為任何更新(模塊的行為)會破壞系統的人,可以配置npm僅安裝精確版本號的模塊:
npm config set save-exact true
另一個選擇是,可以在項目中使用 shrinkwrap:
npm shrinkwrap
這會生成一個 shrinkwrap.json
文件,該文件包含了你正在使用的模塊的指定版本。當運行 npm install
時,該文件所指定的模塊版本會覆蓋 package.json
文件中所指定的版本。
怎麼知道一個模塊已經更新了呢?我之前的方式是先列舉出項目所依賴的模塊(npm list --depth=0
),然後在npmjs.com 上找到該模塊,手動檢查該模塊的版本是否已經更新。這非常費時。幸運的是,有一個更簡單的方式:
npm outdated
或者 npm outdated -g
來查找全局模塊。
你也可以查看一個獨立模塊的當前版本:
npm list <package>
也可以查看檢驗當前和歷史版本:
npm view <package> versions
npm view <package>
會顯示一個獨立模塊的所有信息,包括它的依賴、關鍵字、更新日期、貢獻者、倉庫地址和許可證等。
當你正在開發一個模塊時,會經常想在其它項目中嘗試使用或者在任何一個目錄運行它(如果你的應用支持),這時沒必要將其發布到 npm,並全局安裝—僅需在該模塊所在目錄使用下面的命令:
npn link
該命令會為模塊在全局目錄下創建一個符號鏈接。可以通過下面的命令查看模塊引用:
npm list -g --depth=0
或者:
npm outdated -g
現在,就可以從命令行運行模塊或者通過 require
在任何項目中引入該模塊。
另一個選擇是,可以通過文件路徑在 package.json
文件中聲明對該模塊的依賴:
"dependencies": { "myproject": "file:../myproject/" }