管理員權(quán)限Mac上安裝NVM管理Node版本完整指南)
1. 為什么公司電腦裝個(gè) Node 版本管理器這么折騰如果你拿到的是公司統(tǒng)一配發(fā)的 Mac大概率會(huì)遇到一個(gè)很尷尬的局面終端里敲sudo需要審批/usr/local目錄寫(xiě)不進(jìn)去Homebrew 裝到一半提示權(quán)限不足而項(xiàng)目又要求 Node 14、16、18 來(lái)回切。這時(shí)候你需要的不是管理員密碼而是一套完全落在用戶(hù)目錄里的 Node 版本管理方案。NVMNode Version Manager本身就是一個(gè)純 Shell 腳本工具它的設(shè)計(jì)初衷就是不碰系統(tǒng)目錄、不動(dòng)全局環(huán)境。只要把安裝目錄指向$HOME下的某個(gè)路徑再讓 Shell 啟動(dòng)時(shí)加載一段腳本整個(gè)流程根本不需要管理員權(quán)限。問(wèn)題在于官方安裝腳本默認(rèn)會(huì)往~/.nvm寫(xiě)同時(shí)往~/.zshrc或~/.bash_profile追加配置看起來(lái)簡(jiǎn)單但在國(guó)內(nèi)網(wǎng)絡(luò)環(huán)境下git clone那一步經(jīng)常卡死或者超時(shí)很多人就卡在這里以為沒(méi)權(quán)限裝不了。這篇內(nèi)容面向三類(lèi)人一是公司 Mac 沒(méi)有管理員權(quán)限、又必須管理多個(gè) Node 版本的開(kāi)發(fā)者二是剛接觸 Node.js、被各種版本沖突搞暈的新手三是想搞清楚 NVM 到底改了哪些文件、為什么能免權(quán)限運(yùn)行的技術(shù)好奇者。我會(huì)把安裝路徑選擇、鏡像加速、Shell 配置、常見(jiàn)報(bào)錯(cuò)排查這幾件事拆開(kāi)講透每一步都說(shuō)明為什么這么做而不是甩幾條命令讓你照抄。需要先明確一個(gè)概念NVM 不是包管理器它只負(fù)責(zé)下載和解壓 Node 二進(jìn)制包然后通過(guò)修改PATH環(huán)境變量來(lái)切換當(dāng)前使用的 Node。理解這一點(diǎn)后面所有的路徑問(wèn)題、權(quán)限問(wèn)題都會(huì)變得清晰——它本質(zhì)上就是一堆放在用戶(hù)目錄里的文件夾加上一段 Shell 函數(shù)。2. 安裝前的環(huán)境盤(pán)點(diǎn)與路徑規(guī)劃2.1 先確認(rèn)你手上這臺(tái) Mac 的 Shell 類(lèi)型不同 macOS 版本默認(rèn) Shell 不一樣這直接決定了你后面要改哪個(gè)配置文件。2019 年之后的 macOS 默認(rèn)是zsh更早的是bash。在終端里執(zhí)行echo $SHELL如果輸出/bin/zsh那你改的是~/.zshrc如果輸出/bin/bash改的是~/.bash_profile或~/.bashrc。這一步千萬(wàn)別跳過(guò)我見(jiàn)過(guò)太多人把配置寫(xiě)進(jìn)了~/.bash_profile結(jié)果 zsh 根本不讀重啟終端后nvm命令直接消失然后開(kāi)始懷疑人生。另外確認(rèn)一下當(dāng)前有沒(méi)有裝過(guò) Nodewhich node node -v如果which node返回的是/usr/local/bin/node或/opt/homebrew/bin/node說(shuō)明系統(tǒng)里已經(jīng)有一個(gè)全局 Node 了。這個(gè)不影響 NVM 安裝但后面要注意PATH的優(yōu)先級(jí)否則會(huì)出現(xiàn)裝了 NVM 但node -v還是老版本的情況。2.2 安裝目錄到底放哪里官方默認(rèn)是~/.nvm也就是/Users/你的用戶(hù)名/.nvm。這個(gè)路徑完全在用戶(hù)目錄下天然不需要管理員權(quán)限是最省事的選擇。但有些公司的 Mac 會(huì)對(duì)用戶(hù)主目錄做磁盤(pán)配額或者你有把開(kāi)發(fā)環(huán)境統(tǒng)一放到某個(gè)工作盤(pán)的習(xí)慣那也可以自定義比如~/dev/nvm。這里有個(gè)經(jīng)驗(yàn)路徑里絕對(duì)不要有空格和中文。NVM 的腳本在拼接路徑時(shí)對(duì)空格處理得并不完美一旦路徑含空格nvm use時(shí)可能出現(xiàn)莫名其妙的command not found。我有個(gè)同事把目錄設(shè)成了~/My Tools/nvm排查了兩個(gè)小時(shí)才發(fā)現(xiàn)是空格惹的禍。規(guī)劃好之后先手動(dòng)創(chuàng)建目錄mkdir -p ~/.nvm這一步其實(shí)安裝腳本也會(huì)做但提前建好能讓你更清楚文件到底落在哪。2.3 國(guó)內(nèi)網(wǎng)絡(luò)環(huán)境下的鏡像選擇思路NVM 安裝本身涉及兩個(gè)網(wǎng)絡(luò)環(huán)節(jié)一是下載 NVM 腳本走 GitHub二是后續(xù)用 NVM 下載 Node 二進(jìn)制包走 nodejs.org。這兩個(gè)在國(guó)內(nèi)都可能很慢。對(duì)于 NVM 腳本本身最穩(wěn)的方式是直接從 GitHub 的 raw 地址拉取安裝腳本或者用國(guó)內(nèi)可訪問(wèn)的鏡像站。對(duì)于 Node 二進(jìn)制包NVM 支持通過(guò)環(huán)境變量NVM_NODEJS_ORG_MIRROR指定鏡像源國(guó)內(nèi)常用的有淘寶鏡像npmmirror等。提示鏡像源只是加速下載不改變 NVM 的工作邏輯。設(shè)置鏡像后NVM 依然是從鏡像站拉取官方編譯好的二進(jìn)制包安全性由鏡像站保證選擇時(shí)優(yōu)先用知名度高、維護(hù)活躍的鏡像。3. 免權(quán)限安裝 NVM 的完整操作鏈路3.1 用安裝腳本完成主體安裝最直接的方式是執(zhí)行官方安裝腳本但把安裝目錄顯式指定到用戶(hù)目錄export NVM_DIR$HOME/.nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash這里export NVM_DIR是關(guān)鍵安裝腳本會(huì)讀取這個(gè)變量決定裝到哪。如果不設(shè)它默認(rèn)也是~/.nvm但顯式寫(xiě)出來(lái)更保險(xiǎn)。如果raw.githubusercontent.com訪問(wèn)不暢可以換用鏡像加速地址或者先把install.sh下載到本地再執(zhí)行curl -o install_nvm.sh https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh bash install_nvm.sh下載到本地再執(zhí)行的好處是你能先打開(kāi)文件看一眼它到底干了什么——一個(gè)合格的從業(yè)者應(yīng)該對(duì)自己執(zhí)行的腳本有基本了解。這個(gè)腳本主要做三件事把 NVM 倉(cāng)庫(kù)克隆到$NVM_DIR、嘗試往 Shell 配置文件追加加載語(yǔ)句、提示你重啟終端或手動(dòng) source。3.2 手動(dòng)補(bǔ)全 Shell 配置腳本沒(méi)寫(xiě)成功時(shí)安裝腳本有時(shí)會(huì)因?yàn)檎也坏脚渲梦募^(guò)追加步驟尤其是你用的是比較冷門(mén)的 Shell。這時(shí)候手動(dòng)加。打開(kāi)你的配置文件# zsh 用戶(hù) open -e ~/.zshrc # bash 用戶(hù) open -e ~/.bash_profile在文件末尾追加export NVM_DIR$HOME/.nvm [ -s $NVM_DIR/nvm.sh ] \. $NVM_DIR/nvm.sh [ -s $NVM_DIR/bash_completion ] \. $NVM_DIR/bash_completion第二行是加載 NVM 主腳本第三行是加載命令補(bǔ)全讓你敲nvm ins按 Tab 能補(bǔ)全成nvm install。[ -s ... ]的意思是文件存在且非空才執(zhí)行這樣即使 NVM 沒(méi)裝好也不會(huì)讓終端啟動(dòng)時(shí)報(bào)錯(cuò)。改完保存執(zhí)行source ~/.zshrc然后驗(yàn)證command -v nvm注意這里用command -v nvm而不是which nvm。因?yàn)?NVM 是一個(gè) Shell 函數(shù)不是可執(zhí)行文件which找不到它會(huì)誤報(bào)沒(méi)裝成功。這是新手最容易踩的坑之一。3.3 配置 Node 下載鏡像加速NVM 裝好后下載 Node 才是真正吃網(wǎng)速的環(huán)節(jié)。設(shè)置鏡像環(huán)境變量同樣寫(xiě)進(jìn) Shell 配置文件export NVM_NODEJS_ORG_MIRRORhttps://npmmirror.com/mirrors/node保存后source一下。之后nvm install 18就會(huì)從這個(gè)鏡像拉包速度通常能快好幾倍。如果你還想讓 npm 裝依賴(lài)也走國(guó)內(nèi)源可以順帶設(shè)置npm config set registry https://registry.npmmirror.com這兩件事經(jīng)常被混為一談其實(shí)分工不同NVM_NODEJS_ORG_MIRROR管的是下載 Node 本身npm registry管的是下載項(xiàng)目依賴(lài)包。兩個(gè)都配好整個(gè)鏈路才順暢。4. 裝完之后必須驗(yàn)證的幾件事4.1 安裝并切換第一個(gè) Node 版本nvm install 18 nvm use 18 node -v如果node -v輸出v18.x.x說(shuō)明整條鏈路通了。再裝一個(gè)版本測(cè)試切換nvm install 20 nvm use 20 node -v nvm lsnvm ls會(huì)列出所有已安裝版本并用箭頭標(biāo)出當(dāng)前使用的版本。看到兩個(gè)版本都在列表里、箭頭指向 20就說(shuō)明版本管理功能正常。4.2 設(shè)置默認(rèn)版本避免每次開(kāi)終端都要手動(dòng)切nvm alias default 18這行的作用是新開(kāi)一個(gè)終端窗口時(shí)自動(dòng)使用 18 版本。不設(shè)的話每次新終端都是沒(méi)有 Node的狀態(tài)得手動(dòng)nvm use非常煩。4.3 檢查 PATH 優(yōu)先級(jí)有沒(méi)有被系統(tǒng) Node 搶占前面提到系統(tǒng)里可能已經(jīng)有一個(gè)全局 Node。執(zhí)行echo $PATH看$NVM_DIR/versions/node/v18.x.x/bin是不是排在/usr/local/bin前面。如果系統(tǒng) Node 的路徑在前那node命令會(huì)優(yōu)先用系統(tǒng)的NVM 就白裝了。解決辦法是在 Shell 配置文件里把 NVM 的加載語(yǔ)句放到最后或者手動(dòng)把 NVM 路徑提前。我個(gè)人的習(xí)慣是裝完 NVM 后干脆把系統(tǒng)那個(gè)全局 Node 卸掉如果有權(quán)限的話避免兩套環(huán)境打架。沒(méi)權(quán)限卸也沒(méi)關(guān)系只要保證 PATH 順序正確就行。5. 那些年踩過(guò)的報(bào)錯(cuò)與排查思路5.1nvm: command not found的三種可能這是最高頻的問(wèn)題原因通常有三類(lèi)按可能性排序第一Shell 配置文件改錯(cuò)了。你用的是 zsh卻把配置寫(xiě)進(jìn)了~/.bash_profile。回到 2.1 節(jié)確認(rèn) Shell 類(lèi)型。第二改完沒(méi)source也沒(méi)重開(kāi)終端。配置文件的加載只發(fā)生在終端啟動(dòng)時(shí)改完必須source或重開(kāi)。第三NVM 目錄確實(shí)沒(méi)裝成功。檢查ls ~/.nvm如果里面沒(méi)有nvm.sh說(shuō)明安裝腳本那一步失敗了多半是網(wǎng)絡(luò)問(wèn)題重新執(zhí)行安裝。排查順序建議從確認(rèn) Shell 類(lèi)型開(kāi)始再到確認(rèn)文件存在最后才懷疑網(wǎng)絡(luò)。很多人一上來(lái)就重裝其實(shí)問(wèn)題只是配置文件路徑寫(xiě)錯(cuò)了。5.2 安裝腳本報(bào)git: command not foundNVM 的安裝腳本依賴(lài)git來(lái)克隆倉(cāng)庫(kù)。macOS 自帶 git但如果你的系統(tǒng)比較干凈可能沒(méi)裝。這時(shí)候會(huì)提示你安裝 Xcode Command Line Toolsxcode-select --install這個(gè)安裝不需要管理員權(quán)限彈窗點(diǎn)確認(rèn)即可。裝完再重新跑 NVM 安裝腳本。5.3nvm install卡在下載不動(dòng)基本可以確定是鏡像沒(méi)配好或者配了但沒(méi)生效。先確認(rèn)環(huán)境變量echo $NVM_NODEJS_ORG_MIRROR如果輸出為空說(shuō)明配置沒(méi)加載回去檢查 Shell 配置文件。如果有輸出但還是慢可以換一個(gè)鏡像地址試試或者用nvm install 18 --lts明確指定 LTS 版本減少解析開(kāi)銷(xiāo)。還有一種情況是公司網(wǎng)絡(luò)對(duì)某些域名做了限制這時(shí)候可以嘗試用curl手動(dòng)測(cè)試鏡像站是否可達(dá)curl -I https://npmmirror.com/mirrors/node/返回 200 說(shuō)明通返回超時(shí)或 403 就得換源。5.4 切換版本后全局包消失了這是 NVM 的正常行為不是 bug。每個(gè) Node 版本有獨(dú)立的全局包目錄你在 18 下npm install -g pnpm切到 20 后 pnpm 就沒(méi)了。解決辦法有兩個(gè)一是每個(gè)版本都裝一遍需要的全局包二是用nvm reinstall-packages從舊版本遷移nvm reinstall-packages 18這行會(huì)在當(dāng)前版本下把 18 版本里裝過(guò)的全局包重新裝一遍。我一般在新裝一個(gè) Node 版本后第一件事就是跑這個(gè)命令省得一個(gè)個(gè)手動(dòng)裝。6. 讓 NVM 用起來(lái)更順手的幾個(gè)配置6.1 自動(dòng)切換到項(xiàng)目指定的 Node 版本在項(xiàng)目根目錄放一個(gè).nvmrc文件內(nèi)容寫(xiě)版本號(hào)18然后配合一段 Shell 邏輯進(jìn)入目錄時(shí)自動(dòng)nvm use。zsh 用戶(hù)可以在~/.zshrc里加autoload -U add-zsh-hook load-nvmrc() { if [[ -f .nvmrc -r .nvmrc ]]; then nvm use fi } add-zsh-hook chpwd load-nvmrc load-nvmrc這樣每次cd進(jìn)帶.nvmrc的項(xiàng)目Node 版本自動(dòng)切過(guò)去團(tuán)隊(duì)協(xié)作時(shí)特別省心。注意nvm use不帶參數(shù)時(shí)會(huì)讀.nvmrc如果那個(gè)版本沒(méi)裝它會(huì)提示你先nvm install。6.2 給 npm 也配上鏡像別只配一半前面提過(guò)NVM_NODEJS_ORG_MIRROR只管 Node 下載。項(xiàng)目依賴(lài)走的是 npm得單獨(dú)配npm config set registry https://registry.npmmirror.com npm config get registry第二條命令驗(yàn)證是否生效。如果你用 pnpm 或 yarn也要各自配一遍它們的配置是獨(dú)立的。6.3 定期清理舊版本別讓磁盤(pán)悄悄爆掉每個(gè) Node 版本加上全局包動(dòng)輒幾百 MB。裝多了之后~/.nvm能占好幾個(gè) G。查看已裝版本nvm ls卸載不用的nvm uninstall 14我一般只保留當(dāng)前項(xiàng)目需要的兩三個(gè)版本其余定期清掉。macOS 的磁盤(pán)空間本來(lái)就緊張尤其是 256G 的機(jī)型。7. 關(guān)于無(wú)管理員權(quán)限這件事的幾點(diǎn)體會(huì)回過(guò)頭看NVM 能在無(wú)管理員權(quán)限下工作核心原因就一條它所有的文件都在用戶(hù)目錄所有的安裝本質(zhì)上都是解壓和改環(huán)境變量不涉及系統(tǒng)級(jí)寫(xiě)入。理解了這一點(diǎn)你甚至可以不通過(guò)安裝腳本手動(dòng)把 NVM 倉(cāng)庫(kù) clone 下來(lái)再手動(dòng)配 Shell效果完全一樣。我在幾臺(tái)不同權(quán)限級(jí)別的 Mac 上都裝過(guò) NVM最深的體會(huì)是先把路徑和 Shell 類(lèi)型確認(rèn)清楚比急著敲命令重要得多。很多所謂的權(quán)限問(wèn)題其實(shí)是路徑寫(xiě)錯(cuò)、配置文件改錯(cuò)、PATH 順序不對(duì)造成的假象。真正需要管理員權(quán)限的場(chǎng)景反而是少數(shù)。另外鏡像配置這件事值得單獨(dú)強(qiáng)調(diào)。國(guó)內(nèi)環(huán)境下不配鏡像的 NVM 體驗(yàn)是災(zāi)難級(jí)的配好之后和本地安裝幾乎沒(méi)差別。NVM_NODEJS_ORG_MIRROR和npm registry這兩個(gè)變量建議裝完 NVM 第一件事就設(shè)上能省掉后面無(wú)數(shù)次等待。最后分享一個(gè)小技巧如果你不確定某個(gè)配置到底有沒(méi)有生效別猜直接用echo把變量打出來(lái)看。echo $NVM_DIR、echo $NVM_NODEJS_ORG_MIRROR、echo $PATH這三條命令能解決八成的環(huán)境問(wèn)題。環(huán)境變量這東西看得見(jiàn)才管得住。 無(wú)管理員權(quán)限Mac上安裝NVM管理Node版本完整指南
1. 為什么公司電腦裝個(gè) Node 版本管理器這么折騰如果你拿到的是公司統(tǒng)一配發(fā)的 Mac大概率會(huì)遇到一個(gè)很尷尬的局面終端里敲sudo需要審批/usr/local目錄寫(xiě)不進(jìn)去Homebrew 裝到一半提示權(quán)限不足而項(xiàng)目又要求 Node 14、16、18 來(lái)回切。這時(shí)候你需要的不是管理員密碼而是一套完全落在用戶(hù)目錄里的 Node 版本管理方案。NVMNode Version Manager本身就是一個(gè)純 Shell 腳本工具它的設(shè)計(jì)初衷就是不碰系統(tǒng)目錄、不動(dòng)全局環(huán)境。只要把安裝目錄指向$HOME下的某個(gè)路徑再讓 Shell 啟動(dòng)時(shí)加載一段腳本整個(gè)流程根本不需要管理員權(quán)限。問(wèn)題在于官方安裝腳本默認(rèn)會(huì)往~/.nvm寫(xiě)同時(shí)往~/.zshrc或~/.bash_profile追加配置看起來(lái)簡(jiǎn)單但在國(guó)內(nèi)網(wǎng)絡(luò)環(huán)境下git clone那一步經(jīng)常卡死或者超時(shí)很多人就卡在這里以為沒(méi)權(quán)限裝不了。這篇內(nèi)容面向三類(lèi)人一是公司 Mac 沒(méi)有管理員權(quán)限、又必須管理多個(gè) Node 版本的開(kāi)發(fā)者二是剛接觸 Node.js、被各種版本沖突搞暈的新手三是想搞清楚 NVM 到底改了哪些文件、為什么能免權(quán)限運(yùn)行的技術(shù)好奇者。我會(huì)把安裝路徑選擇、鏡像加速、Shell 配置、常見(jiàn)報(bào)錯(cuò)排查這幾件事拆開(kāi)講透每一步都說(shuō)明為什么這么做而不是甩幾條命令讓你照抄。需要先明確一個(gè)概念NVM 不是包管理器它只負(fù)責(zé)下載和解壓 Node 二進(jìn)制包然后通過(guò)修改PATH環(huán)境變量來(lái)切換當(dāng)前使用的 Node。理解這一點(diǎn)后面所有的路徑問(wèn)題、權(quán)限問(wèn)題都會(huì)變得清晰——它本質(zhì)上就是一堆放在用戶(hù)目錄里的文件夾加上一段 Shell 函數(shù)。2. 安裝前的環(huán)境盤(pán)點(diǎn)與路徑規(guī)劃2.1 先確認(rèn)你手上這臺(tái) Mac 的 Shell 類(lèi)型不同 macOS 版本默認(rèn) Shell 不一樣這直接決定了你后面要改哪個(gè)配置文件。2019 年之后的 macOS 默認(rèn)是zsh更早的是bash。在終端里執(zhí)行echo $SHELL如果輸出/bin/zsh那你改的是~/.zshrc如果輸出/bin/bash改的是~/.bash_profile或~/.bashrc。這一步千萬(wàn)別跳過(guò)我見(jiàn)過(guò)太多人把配置寫(xiě)進(jìn)了~/.bash_profile結(jié)果 zsh 根本不讀重啟終端后nvm命令直接消失然后開(kāi)始懷疑人生。另外確認(rèn)一下當(dāng)前有沒(méi)有裝過(guò) Nodewhich node node -v如果which node返回的是/usr/local/bin/node或/opt/homebrew/bin/node說(shuō)明系統(tǒng)里已經(jīng)有一個(gè)全局 Node 了。這個(gè)不影響 NVM 安裝但后面要注意PATH的優(yōu)先級(jí)否則會(huì)出現(xiàn)裝了 NVM 但node -v還是老版本的情況。2.2 安裝目錄到底放哪里官方默認(rèn)是~/.nvm也就是/Users/你的用戶(hù)名/.nvm。這個(gè)路徑完全在用戶(hù)目錄下天然不需要管理員權(quán)限是最省事的選擇。但有些公司的 Mac 會(huì)對(duì)用戶(hù)主目錄做磁盤(pán)配額或者你有把開(kāi)發(fā)環(huán)境統(tǒng)一放到某個(gè)工作盤(pán)的習(xí)慣那也可以自定義比如~/dev/nvm。這里有個(gè)經(jīng)驗(yàn)路徑里絕對(duì)不要有空格和中文。NVM 的腳本在拼接路徑時(shí)對(duì)空格處理得并不完美一旦路徑含空格nvm use時(shí)可能出現(xiàn)莫名其妙的command not found。我有個(gè)同事把目錄設(shè)成了~/My Tools/nvm排查了兩個(gè)小時(shí)才發(fā)現(xiàn)是空格惹的禍。規(guī)劃好之后先手動(dòng)創(chuàng)建目錄mkdir -p ~/.nvm這一步其實(shí)安裝腳本也會(huì)做但提前建好能讓你更清楚文件到底落在哪。2.3 國(guó)內(nèi)網(wǎng)絡(luò)環(huán)境下的鏡像選擇思路NVM 安裝本身涉及兩個(gè)網(wǎng)絡(luò)環(huán)節(jié)一是下載 NVM 腳本走 GitHub二是后續(xù)用 NVM 下載 Node 二進(jìn)制包走 nodejs.org。這兩個(gè)在國(guó)內(nèi)都可能很慢。對(duì)于 NVM 腳本本身最穩(wěn)的方式是直接從 GitHub 的 raw 地址拉取安裝腳本或者用國(guó)內(nèi)可訪問(wèn)的鏡像站。對(duì)于 Node 二進(jìn)制包NVM 支持通過(guò)環(huán)境變量NVM_NODEJS_ORG_MIRROR指定鏡像源國(guó)內(nèi)常用的有淘寶鏡像npmmirror等。提示鏡像源只是加速下載不改變 NVM 的工作邏輯。設(shè)置鏡像后NVM 依然是從鏡像站拉取官方編譯好的二進(jìn)制包安全性由鏡像站保證選擇時(shí)優(yōu)先用知名度高、維護(hù)活躍的鏡像。3. 免權(quán)限安裝 NVM 的完整操作鏈路3.1 用安裝腳本完成主體安裝最直接的方式是執(zhí)行官方安裝腳本但把安裝目錄顯式指定到用戶(hù)目錄export NVM_DIR$HOME/.nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash這里export NVM_DIR是關(guān)鍵安裝腳本會(huì)讀取這個(gè)變量決定裝到哪。如果不設(shè)它默認(rèn)也是~/.nvm但顯式寫(xiě)出來(lái)更保險(xiǎn)。如果raw.githubusercontent.com訪問(wèn)不暢可以換用鏡像加速地址或者先把install.sh下載到本地再執(zhí)行curl -o install_nvm.sh https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh bash install_nvm.sh下載到本地再執(zhí)行的好處是你能先打開(kāi)文件看一眼它到底干了什么——一個(gè)合格的從業(yè)者應(yīng)該對(duì)自己執(zhí)行的腳本有基本了解。這個(gè)腳本主要做三件事把 NVM 倉(cāng)庫(kù)克隆到$NVM_DIR、嘗試往 Shell 配置文件追加加載語(yǔ)句、提示你重啟終端或手動(dòng) source。3.2 手動(dòng)補(bǔ)全 Shell 配置腳本沒(méi)寫(xiě)成功時(shí)安裝腳本有時(shí)會(huì)因?yàn)檎也坏脚渲梦募^(guò)追加步驟尤其是你用的是比較冷門(mén)的 Shell。這時(shí)候手動(dòng)加。打開(kāi)你的配置文件# zsh 用戶(hù) open -e ~/.zshrc # bash 用戶(hù) open -e ~/.bash_profile在文件末尾追加export NVM_DIR$HOME/.nvm [ -s $NVM_DIR/nvm.sh ] \. $NVM_DIR/nvm.sh [ -s $NVM_DIR/bash_completion ] \. $NVM_DIR/bash_completion第二行是加載 NVM 主腳本第三行是加載命令補(bǔ)全讓你敲nvm ins按 Tab 能補(bǔ)全成nvm install。[ -s ... ]的意思是文件存在且非空才執(zhí)行這樣即使 NVM 沒(méi)裝好也不會(huì)讓終端啟動(dòng)時(shí)報(bào)錯(cuò)。改完保存執(zhí)行source ~/.zshrc然后驗(yàn)證command -v nvm注意這里用command -v nvm而不是which nvm。因?yàn)?NVM 是一個(gè) Shell 函數(shù)不是可執(zhí)行文件which找不到它會(huì)誤報(bào)沒(méi)裝成功。這是新手最容易踩的坑之一。3.3 配置 Node 下載鏡像加速NVM 裝好后下載 Node 才是真正吃網(wǎng)速的環(huán)節(jié)。設(shè)置鏡像環(huán)境變量同樣寫(xiě)進(jìn) Shell 配置文件export NVM_NODEJS_ORG_MIRRORhttps://npmmirror.com/mirrors/node保存后source一下。之后nvm install 18就會(huì)從這個(gè)鏡像拉包速度通常能快好幾倍。如果你還想讓 npm 裝依賴(lài)也走國(guó)內(nèi)源可以順帶設(shè)置npm config set registry https://registry.npmmirror.com這兩件事經(jīng)常被混為一談其實(shí)分工不同NVM_NODEJS_ORG_MIRROR管的是下載 Node 本身npm registry管的是下載項(xiàng)目依賴(lài)包。兩個(gè)都配好整個(gè)鏈路才順暢。4. 裝完之后必須驗(yàn)證的幾件事4.1 安裝并切換第一個(gè) Node 版本nvm install 18 nvm use 18 node -v如果node -v輸出v18.x.x說(shuō)明整條鏈路通了。再裝一個(gè)版本測(cè)試切換nvm install 20 nvm use 20 node -v nvm lsnvm ls會(huì)列出所有已安裝版本并用箭頭標(biāo)出當(dāng)前使用的版本。看到兩個(gè)版本都在列表里、箭頭指向 20就說(shuō)明版本管理功能正常。4.2 設(shè)置默認(rèn)版本避免每次開(kāi)終端都要手動(dòng)切nvm alias default 18這行的作用是新開(kāi)一個(gè)終端窗口時(shí)自動(dòng)使用 18 版本。不設(shè)的話每次新終端都是沒(méi)有 Node的狀態(tài)得手動(dòng)nvm use非常煩。4.3 檢查 PATH 優(yōu)先級(jí)有沒(méi)有被系統(tǒng) Node 搶占前面提到系統(tǒng)里可能已經(jīng)有一個(gè)全局 Node。執(zhí)行echo $PATH看$NVM_DIR/versions/node/v18.x.x/bin是不是排在/usr/local/bin前面。如果系統(tǒng) Node 的路徑在前那node命令會(huì)優(yōu)先用系統(tǒng)的NVM 就白裝了。解決辦法是在 Shell 配置文件里把 NVM 的加載語(yǔ)句放到最后或者手動(dòng)把 NVM 路徑提前。我個(gè)人的習(xí)慣是裝完 NVM 后干脆把系統(tǒng)那個(gè)全局 Node 卸掉如果有權(quán)限的話避免兩套環(huán)境打架。沒(méi)權(quán)限卸也沒(méi)關(guān)系只要保證 PATH 順序正確就行。5. 那些年踩過(guò)的報(bào)錯(cuò)與排查思路5.1nvm: command not found的三種可能這是最高頻的問(wèn)題原因通常有三類(lèi)按可能性排序第一Shell 配置文件改錯(cuò)了。你用的是 zsh卻把配置寫(xiě)進(jìn)了~/.bash_profile。回到 2.1 節(jié)確認(rèn) Shell 類(lèi)型。第二改完沒(méi)source也沒(méi)重開(kāi)終端。配置文件的加載只發(fā)生在終端啟動(dòng)時(shí)改完必須source或重開(kāi)。第三NVM 目錄確實(shí)沒(méi)裝成功。檢查ls ~/.nvm如果里面沒(méi)有nvm.sh說(shuō)明安裝腳本那一步失敗了多半是網(wǎng)絡(luò)問(wèn)題重新執(zhí)行安裝。排查順序建議從確認(rèn) Shell 類(lèi)型開(kāi)始再到確認(rèn)文件存在最后才懷疑網(wǎng)絡(luò)。很多人一上來(lái)就重裝其實(shí)問(wèn)題只是配置文件路徑寫(xiě)錯(cuò)了。5.2 安裝腳本報(bào)git: command not foundNVM 的安裝腳本依賴(lài)git來(lái)克隆倉(cāng)庫(kù)。macOS 自帶 git但如果你的系統(tǒng)比較干凈可能沒(méi)裝。這時(shí)候會(huì)提示你安裝 Xcode Command Line Toolsxcode-select --install這個(gè)安裝不需要管理員權(quán)限彈窗點(diǎn)確認(rèn)即可。裝完再重新跑 NVM 安裝腳本。5.3nvm install卡在下載不動(dòng)基本可以確定是鏡像沒(méi)配好或者配了但沒(méi)生效。先確認(rèn)環(huán)境變量echo $NVM_NODEJS_ORG_MIRROR如果輸出為空說(shuō)明配置沒(méi)加載回去檢查 Shell 配置文件。如果有輸出但還是慢可以換一個(gè)鏡像地址試試或者用nvm install 18 --lts明確指定 LTS 版本減少解析開(kāi)銷(xiāo)。還有一種情況是公司網(wǎng)絡(luò)對(duì)某些域名做了限制這時(shí)候可以嘗試用curl手動(dòng)測(cè)試鏡像站是否可達(dá)curl -I https://npmmirror.com/mirrors/node/返回 200 說(shuō)明通返回超時(shí)或 403 就得換源。5.4 切換版本后全局包消失了這是 NVM 的正常行為不是 bug。每個(gè) Node 版本有獨(dú)立的全局包目錄你在 18 下npm install -g pnpm切到 20 后 pnpm 就沒(méi)了。解決辦法有兩個(gè)一是每個(gè)版本都裝一遍需要的全局包二是用nvm reinstall-packages從舊版本遷移nvm reinstall-packages 18這行會(huì)在當(dāng)前版本下把 18 版本里裝過(guò)的全局包重新裝一遍。我一般在新裝一個(gè) Node 版本后第一件事就是跑這個(gè)命令省得一個(gè)個(gè)手動(dòng)裝。6. 讓 NVM 用起來(lái)更順手的幾個(gè)配置6.1 自動(dòng)切換到項(xiàng)目指定的 Node 版本在項(xiàng)目根目錄放一個(gè).nvmrc文件內(nèi)容寫(xiě)版本號(hào)18然后配合一段 Shell 邏輯進(jìn)入目錄時(shí)自動(dòng)nvm use。zsh 用戶(hù)可以在~/.zshrc里加autoload -U add-zsh-hook load-nvmrc() { if [[ -f .nvmrc -r .nvmrc ]]; then nvm use fi } add-zsh-hook chpwd load-nvmrc load-nvmrc這樣每次cd進(jìn)帶.nvmrc的項(xiàng)目Node 版本自動(dòng)切過(guò)去團(tuán)隊(duì)協(xié)作時(shí)特別省心。注意nvm use不帶參數(shù)時(shí)會(huì)讀.nvmrc如果那個(gè)版本沒(méi)裝它會(huì)提示你先nvm install。6.2 給 npm 也配上鏡像別只配一半前面提過(guò)NVM_NODEJS_ORG_MIRROR只管 Node 下載。項(xiàng)目依賴(lài)走的是 npm得單獨(dú)配npm config set registry https://registry.npmmirror.com npm config get registry第二條命令驗(yàn)證是否生效。如果你用 pnpm 或 yarn也要各自配一遍它們的配置是獨(dú)立的。6.3 定期清理舊版本別讓磁盤(pán)悄悄爆掉每個(gè) Node 版本加上全局包動(dòng)輒幾百 MB。裝多了之后~/.nvm能占好幾個(gè) G。查看已裝版本nvm ls卸載不用的nvm uninstall 14我一般只保留當(dāng)前項(xiàng)目需要的兩三個(gè)版本其余定期清掉。macOS 的磁盤(pán)空間本來(lái)就緊張尤其是 256G 的機(jī)型。7. 關(guān)于無(wú)管理員權(quán)限這件事的幾點(diǎn)體會(huì)回過(guò)頭看NVM 能在無(wú)管理員權(quán)限下工作核心原因就一條它所有的文件都在用戶(hù)目錄所有的安裝本質(zhì)上都是解壓和改環(huán)境變量不涉及系統(tǒng)級(jí)寫(xiě)入。理解了這一點(diǎn)你甚至可以不通過(guò)安裝腳本手動(dòng)把 NVM 倉(cāng)庫(kù) clone 下來(lái)再手動(dòng)配 Shell效果完全一樣。我在幾臺(tái)不同權(quán)限級(jí)別的 Mac 上都裝過(guò) NVM最深的體會(huì)是先把路徑和 Shell 類(lèi)型確認(rèn)清楚比急著敲命令重要得多。很多所謂的權(quán)限問(wèn)題其實(shí)是路徑寫(xiě)錯(cuò)、配置文件改錯(cuò)、PATH 順序不對(duì)造成的假象。真正需要管理員權(quán)限的場(chǎng)景反而是少數(shù)。另外鏡像配置這件事值得單獨(dú)強(qiáng)調(diào)。國(guó)內(nèi)環(huán)境下不配鏡像的 NVM 體驗(yàn)是災(zāi)難級(jí)的配好之后和本地安裝幾乎沒(méi)差別。NVM_NODEJS_ORG_MIRROR和npm registry這兩個(gè)變量建議裝完 NVM 第一件事就設(shè)上能省掉后面無(wú)數(shù)次等待。最后分享一個(gè)小技巧如果你不確定某個(gè)配置到底有沒(méi)有生效別猜直接用echo把變量打出來(lái)看。echo $NVM_DIR、echo $NVM_NODEJS_ORG_MIRROR、echo $PATH這三條命令能解決八成的環(huán)境問(wèn)題。環(huán)境變量這東西看得見(jiàn)才管得住。