npm 緩存占滿 C 盤三步把它遷到 D 盤附驗(yàn)證與避坑問題場(chǎng)景裝了前端項(xiàng)目后 C 盤越來越滿一查發(fā)現(xiàn)npm-cache占了好幾個(gè) GB刪了又會(huì)被重新下載填滿。其實(shí) npm 緩存是可以「搬家」的只要把緩存目錄指到 D 盤既能釋放 C 盤空間又不用重新下載所有依賴。本教程適用Windows 10 / 11npm 5.x 及以上當(dāng)前主流版本 9.x / 10.x 通用。全程用 PowerShell 命令行操作每一步都有命令、有解釋、有驗(yàn)證照著抄就能跑通。一、先搞清楚npm 緩存是什么為什么占 C 盤npm 下載依賴時(shí)會(huì)把下載過的包緩存到本地磁盤。下次安裝同一個(gè)包時(shí)直接復(fù)用緩存安裝速度飛快、也省流量。這就是 npm 的「本地緩存機(jī)制」。但代價(jià)是緩存默認(rèn)放在系統(tǒng)盤C 盤。裝的項(xiàng)目越多、依賴越重比如 node_modules 動(dòng)輒幾百 MB 的前端工程緩存就會(huì)越滾越大通常幾個(gè) GB嚴(yán)重的能到十幾 GB。不同 npm 版本默認(rèn)緩存位置不同Windowsnpm 版本默認(rèn)緩存目錄npm 5.x 及以上主流C:\Users\你的用戶名\AppData\Local\npm-cachenpm 4.x 及更早舊版C:\Users\你的用戶名\AppData\Roaming\npm-cache注意AppData默認(rèn)是隱藏文件夾資源管理器里直接找可能看不到用命令行最方便。遷移思路在 D 盤建一個(gè)新緩存目錄 → 把 npm 的緩存路徑配置改成 D 盤 → 把 C 盤舊緩存復(fù)制過去可保留加速→ 驗(yàn)證后清掉 C 盤舊緩存。二、遷移前先確認(rèn)緩存位置和大小打開 PowerShell按Win X→ 選擇「Windows PowerShell」或「終端」依次執(zhí)行下面命令做到心里有數(shù)。2.1 查看當(dāng)前緩存路徑npm config get cache正常情況下會(huì)輸出類似C:\Users\你的用戶名\AppData\Local\npm-cache2.2 查看緩存占了多大空間把命令里的路徑替換成上面查到的實(shí)際路徑(Get-ChildItemC:\Users\你的用戶名\AppData\Local\npm-cache-Recurse-Force-ErrorAction SilentlyContinue|Measure-Object-Property Length-Sum).Sum/1GB輸出結(jié)果就是緩存占用的GB 數(shù)比如3.4表示約 3.4 GB。2.3 用 npm 自帶的校驗(yàn)命令看緩存npm cache verify這個(gè)命令會(huì)校驗(yàn)緩存完整性并輸出緩存內(nèi)容總量、存放路徑等信息跑完如果發(fā)現(xiàn)「孤兒緩存」它還會(huì)順手清理掉。記下上面查到的當(dāng)前緩存路徑和大小后面復(fù)制和清理都要用到。三、正式遷移四步走全程可復(fù)制步驟 1在 D 盤新建緩存目錄在 D 盤建一個(gè)專門的目錄例如D:\npm-cache名字隨意好記就行New-Item-ItemType Directory-PathD:\npm-cache-Force建議建在 D 盤根目錄下路徑越短越好記也避免中文或空格路徑帶來的坑。步驟 2把 npm 緩存路徑改到 D 盤這一步是核心三種方式任選一種推薦方式 A。方式 A推薦一條命令修改用戶級(jí)配置npm configsetcacheD:\npm-cache這條命令會(huì)把cacheD:\npm-cache寫入用戶級(jí)配置文件.npmrc位于C:\Users\你的用戶名\.npmrc對(duì)當(dāng)前用戶的所有項(xiàng)目全局生效。方式 B直接編輯.npmrc文件找到并打開C:\Users\你的用戶名\.npmrc沒有就新建一個(gè)添加一行cacheD:\npm-cache保存即可效果與方式 A 完全一樣。方式 C設(shè)置環(huán)境變量適合要全自動(dòng)/腳本化在 PowerShell 里執(zhí)行寫入用戶級(jí)環(huán)境變量永久生效setx npm_config_cacheD:\npm-cache注意setx設(shè)置的變量需要重開終端窗口或重新登錄才會(huì)生效不像方式 A/B 即時(shí)生效。改完先驗(yàn)證無論用哪種方式npm config get cache輸出變成D:\npm-cache就說明配置生效了。配置優(yōu)先級(jí)小知識(shí)npm 配置從高到低是「命令行參數(shù) 環(huán)境變量 項(xiàng)目.npmrc 用戶.npmrc 全局.npmrc 內(nèi)置默認(rèn)」。所以如果你的某個(gè)項(xiàng)目里自己寫了一份.npmrc且也設(shè)置了cache那項(xiàng)目?jī)?nèi)的配置會(huì)覆蓋用戶級(jí)配置這一點(diǎn)在「常見問題」里會(huì)再講。步驟 3把 C 盤舊緩存「搬家」到 D 盤保留加速強(qiáng)烈推薦如果直接改路徑新緩存是空的下次安裝所有包都要重新下載。為了不浪費(fèi)之前的緩存加速把 C 盤舊緩存整個(gè)復(fù)制到 D 盤新目錄即可——npm 緩存的_cacache目錄格式是通用的直接復(fù)制就能用。推薦用robocopyWindows 自帶速度快、支持?jǐn)帱c(diǎn)續(xù)傳、報(bào)錯(cuò)信息清晰robocopyC:\Users\你的用戶名\AppData\Local\npm-cacheD:\npm-cache/E/COPY:DAT/R:1/W:1參數(shù)說明/E復(fù)制所有子目錄含空目錄/COPY:DAT復(fù)制數(shù)據(jù)、屬性、時(shí)間戳/R:1 /W:1單個(gè)文件失敗最多重試 1 次、等待 1 秒避免卡住不想用 robocopy也可以用 PowerShell 原生命令Copy-Item-PathC:\Users\你的用戶名\AppData\Local\npm-cache\*-DestinationD:\npm-cache-Recurse-Force穩(wěn)妥原則先復(fù)制、確認(rèn)新緩存可用后再刪舊的不要一開始就Move-Item直接移動(dòng)。緩存目錄里可能有正在被 npm 占用的文件直接移動(dòng)容易出問題。步驟 4驗(yàn)證新緩存可用再清理 C 盤舊緩存校驗(yàn)新緩存讓 npm 掃描一遍 D 盤緩存npm cache verify看到它掃描D:\npm-cache且無報(bào)錯(cuò)說明緩存搬家成功。裝個(gè)包實(shí)測(cè)隨便找個(gè)目錄或現(xiàn)有項(xiàng)目執(zhí)行npm install確認(rèn)正常下載安裝、不報(bào)權(quán)限錯(cuò)誤。確認(rèn)無誤后清掉 C 盤舊緩存。兩條路選一條npm cache clean--force或直接刪除舊目錄更徹底推薦:Remove-Item-PathC:\Users\你的用戶名\AppData\Local\npm-cache-Recurse-Force看效果再看一眼 C 盤可用空間應(yīng)該多出來好幾個(gè) GBGet-PSDriveC|Select-ObjectUsed,Free到這一步遷移就完成了。四、常見問題FAQ改完配置但npm config get cache還是舊路徑① 確認(rèn)是在當(dāng)前用戶下執(zhí)行不要用管理員終端改完又用普通終端看② 檢查是否有項(xiàng)目級(jí).npmrc覆蓋在項(xiàng)目根目錄執(zhí)行npm config get cache會(huì)優(yōu)先讀項(xiàng)目配置③ 用方式 C 環(huán)境變量的要重開終端。復(fù)制完緩存第一次安裝還是全部重新下載正?，F(xiàn)象。npm 緩存存在版本兼容問題——如果你新舊 npm 大版本跨度大比如從 npm 6 直接升到 npm 10舊緩存可能不被識(shí)別npm 會(huì)重建緩存重新下載一次即可之后就好了。不用糾結(jié)緩存本來就是「越快越好丟了也不心疼」。npx 的臨時(shí)包緩存也會(huì)跟著遷走嗎會(huì)。npx 臨時(shí)下載的包緩存在 cache 目錄下的_npx子目錄里會(huì)隨整個(gè)緩存目錄一起搬走。遷了緩存之前全局安裝的包npm i -g會(huì)丟嗎不會(huì)。全局包安裝在另一個(gè)位置由npm config get prefix決定一般是C:\Users\用戶名\AppData\Roaming\npm和緩存目錄無關(guān)互不影響。D 盤目錄沒有寫權(quán)限安裝報(bào) EACCES / EPERM檢查 D 盤是不是有寫入限制如某些公司電腦 D 盤被策略保護(hù)。確認(rèn)后重新執(zhí)行npm config set cache D:\npm-cache指向一個(gè)有寫權(quán)限的路徑即可。緩存還是太大怎么辦①npm cache verify定期跑一跑能自動(dòng)清理損壞/孤兒緩存② 真不需要緩存加速了npm cache clean --force直接清空npm 每次重新下載國(guó)內(nèi)可配合設(shè)置 registry 鏡像下載也不慢。我想把緩存放回 C 盤怎么辦反向操作即可npm config set cache C:\Users\你的用戶名\AppData\Local\npm-cache再把 D 盤緩存復(fù)制回去然后刪掉 D 盤那份?？偨Y(jié)npm 緩存默認(rèn)在 C 盤的AppData\Local\npm-cache日積月累能吃掉好幾個(gè) GB。遷移只需四步——① D 盤新建目錄 → ②npm config set cache改路徑或改.npmrc/ 環(huán)境變量→ ③robocopy把舊緩存復(fù)制過去 → ④ 驗(yàn)證后刪掉 C 盤舊緩存。核心就一條命令npm config set cache D:\npm-cache重點(diǎn)是記得把舊緩存復(fù)制過去別浪費(fèi)之前的下載加速。