nodejs指定版本安裝的正確步驟及常見問題
更新時(shí)間：2025年11月17日 08:48:09 作者：蓁蓁啊
在當(dāng)今的軟件開發(fā)領(lǐng)域,Node.js已成為一種非常流行的開發(fā)工具,特別是對(duì)于需要處理大量并發(fā)請(qǐng)求的應(yīng)用來說,Node.js的高效性能表現(xiàn)得尤為出色,這篇文章主要介紹了nodejs指定版本安裝的正確步驟及常見問題,需要的朋友可以參考下
Node.js 安裝指南（Ubuntu/Debian）
為什么不能用 sudo apt install nodejs？因?yàn)榘姹咎狭耍?/p>
問題診斷
錯(cuò)誤方式
sudo apt install nodejs npm
問題：
- Ubuntu 20.04 官方源：Node.js v10.x（2018年發(fā)布）
- Ubuntu 22.04 官方源：Node.js v12.x（2019年發(fā)布）
- Ubuntu 24.04 官方源：Node.js v18.x（勉強(qiáng)夠用，但不是最新）
chrome-devtools-mcp 需要：Node.js ≥18
正確方式：使用 NodeSource 官方源
方法1：一鍵安裝（推薦）
# 安裝 Node.js 20.x（LTS 版本，推薦） curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs # 驗(yàn)證安裝 node --version # 應(yīng)該顯示 v20.x.x npm --version # 應(yīng)該顯示 v10.x.x
方法2：使用國內(nèi)鏡像（網(wǎng)絡(luò)不好時(shí)）
# 使用阿里云鏡像 curl -fsSL https://mirrors.aliyun.com/nodesource/deb_20.x/setup | sudo -E bash - sudo apt-get install -y nodejs # 驗(yàn)證安裝 node --version npm --version
升級(jí)已有的舊版本
步驟1：檢查當(dāng)前版本
node --version
如果顯示 v10.x、v12.x、v14.x、v16.x，需要升級(jí)。
步驟2：卸載舊版本
sudo apt remove nodejs npm sudo apt autoremove
步驟3：安裝新版本
# 使用 NodeSource 官方源 curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs # 驗(yàn)證 node --version # 應(yīng)該顯示 v20.x.x
版本選擇
| 版本 | 狀態(tài) | 推薦場(chǎng)景 | 安裝命令 |
|---|---|---|---|
| Node.js 20.x | LTS（長期支持） | ? 生產(chǎn)環(huán)境、日常使用 | setup_20.x |
| Node.js 22.x | Current（最新） | 嘗鮮、測(cè)試新特性 | setup_22.x |
| Node.js 18.x | LTS（維護(hù)中） | 兼容性要求高的項(xiàng)目 | setup_18.x |
推薦：使用 Node.js 20.x（LTS）
常見問題
Q1: curl: command not found
sudo apt update sudo apt install curl
Q2: 安裝腳本下載失敗
原因： 網(wǎng)絡(luò)問題或 GFW
解決： 使用國內(nèi)鏡像
# 阿里云鏡像 curl -fsSL https://mirrors.aliyun.com/nodesource/deb_20.x/setup | sudo -E bash - sudo apt-get install -y nodejs
Q3: npm 權(quán)限錯(cuò)誤
# 問題：npm install -g 提示權(quán)限錯(cuò)誤 npm install -g some-package # Error: EACCES: permission denied # 解決方案1：配置 npm 全局目錄（推薦） mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc # 解決方案2：使用 sudo（不推薦） sudo npm install -g some-package
Q4: 如何切換 Node.js 版本？
使用 nvm（Node Version Manager）：
# 安裝 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash source ~/.bashrc # 安裝多個(gè)版本 nvm install 20 nvm install 18 # 切換版本 nvm use 20 nvm use 18 # 設(shè)置默認(rèn)版本 nvm alias default 20
Q5: 卸載 Node.js
# 卸載通過 apt 安裝的 Node.js sudo apt remove nodejs npm sudo apt autoremove # 清理 NodeSource 源 sudo rm -f /etc/apt/sources.list.d/nodesource.list sudo apt update # 清理用戶數(shù)據(jù) rm -rf ~/.npm rm -rf ~/.nvm
驗(yàn)證安裝
完整檢查清單
# 1. 檢查 Node.js 版本
node --version
# 預(yù)期：v20.x.x 或更高
# 2. 檢查 npm 版本
npm --version
# 預(yù)期：v10.x.x 或更高
# 3. 檢查 npx
npx --version
# 預(yù)期：v10.x.x 或更高
# 4. 測(cè)試運(yùn)行
node -e "console.log('Node.js 工作正常！')"
# 預(yù)期：輸出 "Node.js 工作正常！"
# 5. 測(cè)試 npm
npm --version
# 預(yù)期：顯示版本號(hào)
# 6. 測(cè)試全局安裝（可選）
npm install -g cowsay
cowsay "安裝成功！"
npm uninstall -g cowsay
為什么選擇 NodeSource？
| 對(duì)比項(xiàng) | Ubuntu 官方源 | NodeSource 官方源 |
|---|---|---|
| 更新速度 | ? 慢（跟隨 Ubuntu 發(fā)布周期） | ? 快（跟隨 Node.js 發(fā)布） |
| 版本 | ? 老舊（v10-v18） | ? 最新（v18-v22） |
| 安全更新 | ? 有 | ? 有 |
| 穩(wěn)定性 | ? 高 | ? 高 |
| 官方支持 | ? 社區(qū)維護(hù) | ? Node.js 官方認(rèn)可 |
結(jié)論：NodeSource 是 Ubuntu/Debian 上安裝 Node.js 的最佳方式。
快速命令參考
# 安裝 Node.js 20.x（推薦） curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs # 國內(nèi)鏡像版本 curl -fsSL https://mirrors.aliyun.com/nodesource/deb_20.x/setup | sudo -E bash - && sudo apt-get install -y nodejs # 升級(jí)已有版本 sudo apt remove nodejs npm && sudo apt autoremove && curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs # 驗(yàn)證安裝 node --version && npm --version
參考資源
- NodeSource 官方倉庫： https://github.com/nodesource/distributions
- Node.js 官網(wǎng)： https://nodejs.org/
- Node.js 發(fā)布計(jì)劃： https://github.com/nodejs/release#release-schedule
- 阿里云鏡像： https://developer.aliyun.com/mirror/
“Don’t use the distro Node.js. It’s always outdated.”
— 每個(gè)遇到過版本問題的開發(fā)者
總結(jié)
到此這篇關(guān)于nodejs指定版本安裝的正確步驟及常見問題的文章就介紹到這了,更多相關(guān)nodejs指定版本安裝內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
詳解node child_process模塊學(xué)習(xí)筆記
這篇文章主要介紹了詳解node child_process模塊學(xué)習(xí)筆記，小編覺得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧2018-01-01
這篇文章主要介紹了node.js中joi模塊的基本使用方式，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2022-09-09
這篇文章主要介紹了npm的lock機(jī)制解析，小編覺得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧2019-06-06
這篇文章主要介紹了修改NPM全局模式的默認(rèn)安裝路徑的方法，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-12-12
node自定義安裝更改npm全局模塊默認(rèn)安裝路徑的步驟
有段時(shí)間沒用npm了，新建個(gè)項(xiàng)目，需要改變npm全局包默認(rèn)安裝的路徑，本文就來介紹一下node自定義安裝更改npm全局模塊默認(rèn)安裝路徑的步驟，感興趣的可以了解下2021-09-09
nodejs中的模塊化是指將每個(gè)js文件會(huì)被認(rèn)為單獨(dú)一個(gè)的模塊。模塊之間是互相不可見的。如果一個(gè)模塊需要使用另一個(gè)模塊，那么需要通過指定語法來引入要使用的模塊，而且只能使用引入模塊所暴露的內(nèi)容2022-08-08
Node.js 緩沖區(qū)（Buffer）模塊的方法及實(shí)例分析
在本篇文章里小編給大家整理了一篇關(guān)于Node.js 緩沖區(qū)（Buffer）模塊的方法及實(shí)例分析，對(duì)此有興趣的朋友們可以跟著學(xué)習(xí)下。2022-01-01
nodejs執(zhí)行javaScript原理超詳細(xì)講解
Node.js是目前非常流行的JavaScript運(yùn)行環(huán)境,其背后有著強(qiáng)大的libuv庫支撐其非阻塞I/O操作,這篇文章主要介紹了nodejs執(zhí)行javaScript原理的相關(guān)資料,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下2025-11-11
這篇文章主要介紹了Node.js本地文件操作之文件拷貝與目錄遍歷的方法,拷貝用到了Node的文件API,遍歷則舉了一個(gè)異步API實(shí)現(xiàn)的形式(Node的一大特點(diǎn)),需要的朋友可以參考下2016-02-02
node.js利用mongoose獲取mongodb數(shù)據(jù)的格式化問題詳解
這篇文章主要給大家介紹了關(guān)于node.js利用mongoose獲取mongodb數(shù)據(jù)的格式化問題，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)把。2017-10-10