Node.JS安裝及環(huán)境配置完整步驟(萬字詳細版)
本章節(jié)我們將向大家介紹在 Windows上安裝 Node.js 的方法。
Node.js 安裝包及源碼下載地址為:https://nodejs.org/en/download。

- Package Manager:
- 使用系統(tǒng)自帶的包管理工具(如
apt、yum、brew)安裝。 - 自動管理依賴和更新,適合命令行用戶。
- 使用系統(tǒng)自帶的包管理工具(如
- Prebuilt Installer:
- 官方提供的安裝程序,適用于 Windows 和 macOS。
- 圖形化安裝界面,包含 Node.js 和 npm。
- Prebuilt Binaries:
- 預編譯好的二進制文件,直接下載后解壓即可使用。
- 適合有技術背景、希望自定義安裝位置的用戶。
- Source Code:
- Node.js 的源代碼,需用戶自行編譯。
- 提供最大靈活性,適合高級用戶和需要自定義配置的開發(fā)者。
Node.js 官方針對不同系統(tǒng)已經(jīng)給出了非常詳細的安裝命令,你可以根據(jù)不同平臺系統(tǒng)選擇你需要的 Node.js 安裝命令腳本。
官方網(wǎng)站提供兩個版本:
- **LTS(Long Term Support):**長期支持版本,推薦用于生產(chǎn)環(huán)境
- **Current:**當前最新版本,包含最新特性
建議選擇 LTS 版本,因為它更穩(wěn)定且有長期技術支持。
Node.js 歷史版本下載地址:https://nodejs.org/dist/
Windows 上安裝 Node.js
你可以采用以下兩種方式來安裝。
1、Windows 安裝包(.msi)

安裝步驟:
1、雙擊下載后的安裝包,如下所示:

2、點擊以上的 Next 按鈕,將出現(xiàn)如下界面:

3、勾選接受協(xié)議選項,點擊 Next 按鈕 :

4、Node.js默認安裝目錄為 “C:\Program Files\nodejs” , 你可以修改目錄,并點擊 Next 按鈕:

5、點擊 Install(安裝) 開始安裝 Node.js,你也可以點擊 Back(返回)來修改先前的配置:

安裝過程:

點擊 Finish(完成)按鈕退出安裝向?qū)А?/p>

安裝完成后,我們可以在命令行或 Windows Powershell 中執(zhí)行以下命令來測試:
node -v npm -v

2、Windows 二進制文件 (.exe)安裝
點擊 “Prebuilt Binaries” 選項下載二進制文件:

安裝步驟
步驟 1 : 雙擊下載的安裝包 Node.exe ,將出現(xiàn)如下界面 :

點擊 Run(運行)按鈕將出現(xiàn)命令行窗口:
安裝完成后,我們可以在命令行或 Windows Powershell 中執(zhí)行以下命令來測試:
node -v npm -v

如果你獲得以上輸出結(jié)果,說明你已經(jīng)成功安裝了Node.js。
使用命令行安裝
我們也可以在 PowerShell 執(zhí)行以下命令來安裝:
# 安裝 fnm(快速 Node 管理器) winget install Schniz.fnm # 配置 fnm 環(huán)境,使其在每次目錄變更時自動使用 fnm env --use-on-cd | Out-String | Invoke-Expression # 下載并安裝 Node.js 版本 22 fnm use --install-if-missing 22 # 驗證環(huán)境中 Node.js 的版本是否正確,輸出應為 `v22.11.0` node -v # 應該輸出 `v22.11.0` # 驗證環(huán)境中 npm 的版本是否正確,輸出應為 `10.9.0` npm -v # 應該輸出 `10.9.0`
Linux 上安裝 Node.js
1、使用官方提供的安裝腳本

本例以 fnm 安裝包管理器位說明(也可以使用 nvm等),命令如下:
# 安裝 fnm(快速 Node 管理器) curl -fsSL https://fnm.vercel.app/install | bash # 激活 fnm source ~/.bashrc # 下載并安裝 Node.js fnm use --install-if-missing 22 # 驗證環(huán)境中的 Node.js 版本是否正確 node -v # 應該輸出 `v22.11.0` # 驗證環(huán)境中的 npm 版本是否正確 npm -v # 應該輸出 `10.9.0`
2、直接使用已編譯好的包
點擊 “Prebuilt Binaries” 選項下載二進制文件:

Node 官網(wǎng)已經(jīng)把 linux 下載版本更改為已編譯好的版本了,我們可以直接下載解壓后使用:
# wget https://nodejs.org/dist/v22.11.0/node-v22.11.0-linux-arm64.tar.xz // 下載 # tar xf node-v22.11.0-linux-arm64.tar.xz // 解壓 # cd node-v22.11.0-linux-arm64/ // 進入解壓目錄 # ./bin/node -v // 執(zhí)行node命令 查看版本
解壓文件的 bin 目錄底下包含了 node、npm 等命令,我們可以使用 ln 命令來設置軟連接:
ln -s /usr/software/nodejs/bin/npm /usr/local/bin/ ln -s /usr/software/nodejs/bin/node /usr/local/bin/
3、源碼安裝 Node.js
以下部分我們將介紹在 Ubuntu Linux 下使用源碼安裝 Node.js 。 其他的 Linux 系統(tǒng),如 Centos 等類似如下安裝步驟。
在 Github 上獲取 Node.js 源碼:
$ sudo git clone https://github.com/nodejs/node.git Cloning into 'node'...
修改目錄權(quán)限:
$ sudo chmod -R 755 node
使用 ./configure 創(chuàng)建編譯文件,并按照:
$ cd node $ sudo ./configure $ sudo make $ sudo make install
查看 node 版本:
$ node --version v0.10.25
Mac OS 上安裝
1、使用官方提供的安裝腳本

本例以 nvm 安裝包管理器位說明(也可以使用 fnm 等),命令如下:
# 安裝 nvm(Node 版本管理器) curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash # 下載并安裝 Node.js(可能需要重啟終端) nvm install 22 # 驗證環(huán)境中的 Node.js 版本是否正確 node -v # 應該輸出 `v22.11.0` # 驗證環(huán)境中的 npm 版本是否正確 npm -v # 應該輸出 `10.9.0`
2、使用預編譯等安裝工具

下載的 .pkg 文件,雙擊 .pkg 文件以啟動安裝向?qū)А?/p>
3、直接使用已編譯好的包

下載后,解壓下載包,進入壓縮包的 bin 目錄,就可以看到已經(jīng)編譯好的 node 和 npm 了,可以直接在命令使用。
環(huán)境配置
(1)找到剛剛安裝的目錄,在安裝目錄下新建兩個文件夾【node_global】和【node_cache】


(2)創(chuàng)建完畢后,復制剛剛創(chuàng)建的【node_global】和【node_cache】文件夾路徑在cmd命令分別輸入以下兩條命令,注意不要兩條命令的文件路徑不要搞混了。
注:可以打開所創(chuàng)建的文件夾,把鼠標放在箭頭指向的位置選擇復制。


使用管理員身份打開cmd命令窗口(打開方法見下方Tips),輸入以下命令(下面的路徑是我創(chuàng)建的文件夾所在的路徑,需要復制你們自己創(chuàng)建的路徑哦)
①npm config set prefix “你的路徑\node_global” (復制剛剛所創(chuàng)建的“node_global”文件夾路徑)
npm config set prefix "D:\common\develop\Nodejs\node_global"
②npm config set cache “你的路徑\node_cache” (復制剛剛所創(chuàng)建的“node_cache”文件夾路徑)
npm config set cache “D:\common\develop\Nodejs\node_cache”

-----------可以輸入以下兩條命令查看路徑是否配置正確------------

Tips: 使用管理員身份運行cmd的方法 :點擊左下角【開始】菜單,在搜索區(qū)域輸入“命令提示符”,然后點擊【以管理員身份運行】

=或單擊鼠標右鍵選擇【以管理員身份運行】============

(3)配置環(huán)境變量
①【此電腦】-單擊右鍵-【屬性】-【高級系統(tǒng)設置】-【環(huán)境變量】


② 在【系統(tǒng)變量】中點擊【新建】

變量名:NODE_PATH
變量值:D:\common\develop\Nodejs\node_global\node_modules

隨后在后續(xù)安裝完express模塊之后就會發(fā)現(xiàn)在【node_global】里自動多出了一個【node_modules】文件夾

③編輯【用戶變量】中的【Path】

④將默認的 C 盤下【 AppData\Roaming\npm 】修改成 【node_global】的路徑,點擊【確定】

⑤在【系統(tǒng)變量】中選擇【Path】點擊【編輯】后點擊新建【%NODE_PATH%】,隨后一直點擊【確定】直到關閉所有窗口即可。

四、測試
配置完成后,全局安裝一個最常用的 express 模塊進行測試(使用管理員方式打開cmd)
npm install express -g // -g代表全局安裝
出現(xiàn)以下界面即為配置成功

如果沒有使用管理員方式打開cmd窗口的話,可能會報以下錯誤

解決方法①:
在【C盤】下的【用戶】找到 .npmmrc 文件,并將它刪除(注意不是安裝目錄下的npm模塊里的.npmmrc 文件,而是【C:\Users{用戶}\下的.npmrc文件】)

刪除之后在cmd窗口重新輸入 npm install express -g ,則顯示安裝成功。
解決方法②:
找到安裝目錄下的【node_global】和【node_cache】文件夾,鼠標右擊【node_global】的文件夾,點擊【屬性】,再點擊【安全】,再點擊【編輯】,將權(quán)限都勾上,隨即點擊【確定】即可,【node_cache】步驟同理。
配置完成之后在cmd窗口重新輸入 npm install express -g ,則顯示安裝成功。
五、安裝淘寶鏡像
淘寶鏡像是淘寶團隊為國內(nèi)用戶提供的npm鏡像源,它與官方鏡像源保持同步,并提供了更快的下載速度。
①安裝淘寶鏡像
npm config set registry https://registry.npmmirror.com
查看是否成功:
npm config get registry

②安裝cnpm(按需安裝)
說明: npm是node官方的包管理器。cnpm是個中國版的npm,是淘寶定制的 cnpm (gzip 壓縮支持) 命令行工具代替默認的 npm。
npm install -g cnpm --registry=https://registry.npmmirror.com
查看是否安裝成功
命令: cnpm -v

在查看版本號的時候,可能會出現(xiàn)【 ‘cnpm’ 不是內(nèi)部或外部命令,也不是可運行的程序】的提示信息。
輸入 npm config ls 查看配置信息,如果prefix和cache為以下路徑則表示前面沒有配置成功或者漏配了,需重新輸入配置命令。


注:確認配置路徑為自己創(chuàng)建的文件路徑,修改結(jié)束之后先輸入 npm uninstall cnpm -g 卸載原先安裝的cnpm后再重新輸入安裝命令,最后查看版本號成功即安裝成功。
附加:如果有出現(xiàn)問題的小伙伴們可以檢查一下自己的配置有沒有出錯
①打開cmd敲以下命令檢查
②打開環(huán)境變量配置檢查
用戶變量
系統(tǒng)變量
③打開安裝目錄檢查是否有以下文件夾
····檢查【node_global】里是否有【node_modules】文件夾
····上面所安裝的cnpm、express會出現(xiàn)在【node_global】下的【node_modules】文件夾里
結(jié)尾

注:確認配置路徑為自己創(chuàng)建的文件路徑,修改結(jié)束之后先輸入 npm uninstall cnpm -g 卸載原先安裝的cnpm后再重新輸入安裝命令,最后查看版本號成功即安裝成功。
附加:如果有出現(xiàn)問題的小伙伴們可以檢查一下自己的配置有沒有出錯
①打開cmd敲以下命令檢查
②打開環(huán)境變量配置檢查
用戶變量
系統(tǒng)變量
③打開安裝目錄檢查是否有以下文件夾
····檢查【node_global】里是否有【node_modules】文件夾
····上面所安裝的cnpm、express會出現(xiàn)在【node_global】下的【node_modules】文件夾里
總結(jié)
到此這篇關于Node.JS安裝及環(huán)境配置完的文章就介紹到這了,更多相關Node.JS安裝及環(huán)境配置內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家!
相關文章
Node.js 文件夾目錄結(jié)構(gòu)創(chuàng)建實例代碼
下面小編就為大家?guī)硪黄狽ode.js 文件夾目錄結(jié)構(gòu)創(chuàng)建實例代碼。小編覺得挺不錯的,現(xiàn)在就分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2016-07-07
npm dose not support Node.js v10.15
這篇文章主要給大家介紹了關npm dose not support Node.js v10.15.3的解決方法,文中通過圖文介紹的非常詳細,對大家的學習或者工作具有一定的參考借鑒價值,需要的朋友可以參考下2023-11-11

