萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Node.js 全局模塊命令無法識別('xxx' 不是內部或外部命令)解決方案

問題現象

安裝全局包(如 npm install -g webpack)後,在 CMD/PowerShell 輸入 webpack 提示:

'webpack' 不是內部或外部命令,也不是可運行的程序或批處理文件。

根本原因

npm 全局安裝目錄(prefix)未加入系統環境變量 PATH,導致 Shell 找不到可執行文件(.cmd/.ps1 腳本)。

解決步驟(Windows)

  1. 查詢 npm 全局目錄:
    npm config get prefix
    典型輸出:C:\Users\<用戶名>\AppData\Roaming\npm
  2. 加入系統 PATH:
    • Win+S 搜索「編輯系統環境變量」→ 環境變量
    • 在「系統變量」找到 Path → 編輯 → 新建 → 貼上上一步路徑
    • 確定保存
  3. 重啟終端:關閉所有 CMD/PowerShell/VS Code 終端,重新打開。
  4. 驗證:輸入 webpack -v 應正常顯示版本號。

圖示說明

Node.js 全局目錄環境變量設置截圖

進階:自定義全局目錄(推薦)

避免權限問題,建議將全局目錄設為非系統盤用戶目錄:

# 建立自定義目錄
mkdir D:\nodejs_global
mkdir D:\nodejs_cache

# 設定 npm
npm config set prefix "D:\nodejs_global"
npm config set cache "D:\nodejs_cache"

# 將 D:\nodejs_global 加入 PATH(同上步驟)

Mac/Linux 同理

# 查詢目錄
npm config get prefix
# 典型:/usr/local 或 ~/.npm-global

# 加入 PATH(以 zsh 為例)
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

常見誤區

  • ❌ 以管理員身份運行 npm install -g(會導致權限混亂)
  • ❌ 手動複製 .cmd 文件到 C:\Windows(極不推薦)
  • ✅ 正確設置 prefix 並加入 PATH
  • ✅ 使用 nvm (Windows 用 nvm-windows) 管理 Node 版本,自動處理 PATH
copyright © 萬盛學電腦網 all rights reserved