引言
不同的項目運行時可能需要不同的node版本才可以運行,由于來回進行卸載不同版本的node比較麻煩;所以需要使用node工程多版本管理。
本人在配置時,通過網絡搜索教程,由于文章時間過老,或者文章的互相拷貝導致配置時出現許多小問題,但最后也是配置成功了,想寫下此文章幫助小伙伴們排除錯誤,節省各位寶貴的時間,如有問題歡迎留言討論~
注意:安裝nvm時不能安裝任何node版本(如存在請刪除后再安裝nvm),再檢查環境變量,如果還有node.js相關也刪掉,保證系統無任何node.js 殘留。
卸載完之后cmd命令行輸入 node -v 查看是否還能查到node信息,無的話表示刪除干凈。
安裝前準備
- 若已安裝Node.js,需徹底卸載避免沖突
1.控制面板卸載:進入控制面板 → 卸載Node.js程序。
2.刪除殘留文件:
- 刪除安裝目錄:C:\Program Files\nodejs(或自定義路徑)
- 刪除用戶目錄下的.npmrc文件:C:\Users\用戶名
- 清理以下目錄(若存在):
C:\Program Files (x86)\Nodejs
C:\Users\用戶名\AppData\Roaming\npm
C:\Users\用戶名\AppData\Roaming\npm-cache
3.檢查卸載結果:
node -v # 若提示“找不到命令”則表示卸載成功
一、Nvm的下載與安裝
1.1 Nvm下載
很多博主給的是GitHub上的下載地址,但是在國內訪問速度非常慢,大家可以通過本人的網盤地址下載。點擊下載Nvm,提取碼:B66S
1.2 Nvm的安裝與配置
1.安裝準備(示例:本人在D盤下創建了Nvm文件夾,并在該文件夾下創建了nodejs文件夾)
2.雙擊運行 nvm-setup.exe
3.選擇nvm安裝路徑(示例:D:\nvm,避免中文和空格)
4.設置Node.js存儲路徑(示例:D:\nvm\nodejs)
5.配置鏡像加速(避免下載失敗)
打開nvm安裝目錄下的 settings.txt 文件,添加以下內容:
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/
(舊版淘寶鏡像 registry.npm.taobao.org 證書已過期,需替換為該域名)
6.環境變量配置
1.右擊此電腦點擊屬性
2.選擇高級系統設置
3.點擊環境變量
4.查看環境變量是否配置(默認nvm安裝成功后,自動生成)
1.3 驗證Nvm是否安裝成功
完成安裝后,以管理員身份打開CMD,輸入 nvm -v 驗證是否成功
二、使用Nvm安裝node
2.1 相關命令
nvm list available # 查看可下載的node版本
nvm install v #下載node指定版本 v(版本號) 如:nvm install 20.11.1
nvm list #查看已下載的node版本
nvm use v #使用node指定版本 注:use指令需要使用管理員權限
nvm uninstall v #卸載指定版本 如:nvm uninstall 20.11.1
2.2使用Nvm安裝node
1.win + R,調用cmd
安裝完成后開始插入nodejs首先使用 nvm list available 查詢可插入版本號,LST表示可插入穩定版本。【如未指定版本,建議安裝LTS下的版本】
2.安裝指定node.js版本(這里根據需求選擇)
點我查看node相關版本號
nvm install 18.16.0 #根據自己的需求選擇版本號
3.安裝完成后使用nvm use v
命令使用安裝的node版本
可以分別輸入命令行 node -v
和 npm -v
,檢驗node.js以及對應npm是否安裝成功
4.nvm list
查看當前已安裝的node.js版本,帶*號的是正在使用的
5.安裝成功后的文件夾顯示
***馬上成功了,請堅持一下!***
2.3 修改npm默認鏡像源為淘寶鏡像
修改npm鏡像源為淘寶鏡像,加快npm包的下載速度,減少發生連接錯誤和超時的概率。
1.在命令提示窗口運行下面命令
npm config set registry https://registry.npmmirror.com
2.檢查是否設置淘寶鏡像成功
npm config get registry
三、配置node環境變量
3.1創建目錄
在Node.js存儲路徑下新建 node_global 和 node_cache 文件夾
3.2 設置npm全局路徑:
npm config set prefix "D:\nvm\nodejs\node_global"
npm config set cache "D:\nvm\nodejs\node_cache"
3.3 配置環境變量path
- 編輯用戶變量中的Path
注意:【用戶變量】中的path變量,%NVM_HOME% 和 %NVM_SYMLINK% 理論上是nvm安裝成功后自動生成的。> 如果有C:UsershuaAppDataRoaming npm,則將其修改為D:\NVM\node_global,如果沒有就自己新建D:\NVM\node_global,總之保證有以上內容。
- 再設置系統變量 — Path變量的設置和用戶變量中一致
3.4 添加系統變量:
- 新建 NODE_HOME → 值:D:\nvm\nodejs
D:\tools\nodejs\node_global\node_modules 就是上面創建的全局模塊安裝路徑文件夾
點擊三次確定,完成環境變量配置!!!
點擊三次確定,完成環境變量配置!!!
點擊三次確定,完成環境變量配置!!!
四、測試安裝全局模塊(測試環境變量配置)
- 測試是否環境變量是否配置成功,在cmd窗口中輸入以下指定全局安裝express模塊
npm install -g express
- 安裝成功的話表示環境變量配置成功
五、安裝Vue
1.確保配置了淘寶的鏡像源,可以用npm config get registry
進行測試
2.安裝vue、vue-cli、webpack
npm install vue -g
npm install vue-cli -g
npm install webpack -g
3.檢查Vue是否安裝成功
使用vue -V
命令
返回版本號則說明安裝成功,注意V是大寫,小寫不成功
六、擴展:使用 nrm 來管理 npm 源
6.1 nrm的概念
nrm 允許開發者通過命令行工具輕松管理多個 npm 鏡像源(如淘寶、騰訊云、華為云等),并支持一鍵切換,無需手動修改 npm config。
提供源測速功能(nrm test),幫助選擇響應最快的鏡像。
我們可以使用 nrm 來管理 npm 源,特別是當需要在不同的網絡環境之間切換時,它可以提供更好的包管理體驗。一般國內就是用淘寶源,所以這部分了解即可
6.2 使用 nrm 來管理 npm 源
1.全局安裝(需 Node.js 環境)
npm install -g nrm
2.核心操作命令
nrm ls #查看所有源(帶 * 為當前使用源)
nrm use taobao # 切換到淘寶源(推薦國內使用)
nrm test # 測試所有源延遲
nrm test taobao # 僅測試淘寶源
nrm add my-registry http://私有源地址 # 示例:企業私有源
nrm del my-registry # 刪除指定源
nrm current #當前正在使用的 npm 源