Mac系统下vue命令未找到求助：全局安装@vue/cli无效

Hey there, let's work through this issue step by step—missing global npm commands are a super common hiccup, but we can track down what's going on.

• First, confirm where npm stores global packages
  Run npm config get prefix in your terminal. This will spit out the root directory where npm keeps global packages and their executable commands. Examples:

  • On macOS/Linux, it might be /usr/local or ~/.npm-global
  • On Windows, it’s usually %APPDATA%\npm

• Check if the vue executable actually exists in that path
  Head to the bin subfolder of the prefix directory you just found and verify vue is there:

  • macOS/Linux: Run ls $(npm config get prefix)/bin and look for vue
  • Windows: Run dir %APPDATA%\npm (if using the default prefix) and check for vue.cmd or vue.ps1

  If vue isn’t present, your install likely failed silently. Try reinstalling with verbose output to catch errors:
  npm install -g @vue/cli --verbose

• Make sure the global bin directory is in your system’s PATH
  If vue exists but your terminal can’t find it, the problem is that npm’s global bin folder isn’t added to your system’s PATH environment variable.

  • Check your current PATH:
    • macOS/Linux: echo $PATH
    • Windows: echo %PATH%
  • Add the path if it’s missing:
    • macOS/Linux: Open your shell config file (~/.bashrc, ~/.zshrc, etc.) and add this line:
      export PATH="$(npm config get prefix)/bin:$PATH"
      Then reload the config with source ~/.bashrc or source ~/.zshrc
    • Windows: Open System Properties → Advanced → Environment Variables, find the PATH variable (user or system), add %APPDATA%\npm (or your custom prefix’s bin folder), then restart your terminal.

• Fix permission issues from using sudo
  Using sudo to install global packages can mess up directory permissions, making the vue command inaccessible to your regular user. Here’s how to fix it:

  1. Create a custom global npm directory: mkdir ~/.npm-global
  2. Tell npm to use this directory: npm config set prefix '~/.npm-global'
  3. Add the new directory’s bin folder to your PATH (follow the steps above for your OS)
  4. Reinstall @vue/cli without sudo: npm install -g @vue/cli

• Check for Node version managers (like nvm)
  If you use tools like nvm, each Node.js version has its own set of global packages. If you switched Node versions after installing @vue/cli, the vue command won’t be available in your current version. Run nvm list to see your active Node version, then reinstall @vue/cli for that version.

• Clean npm cache and reinstall as a last resort
  Sometimes cached files can cause weird issues. Clear the cache with:
  npm cache clean --force
  Then uninstall and reinstall:
  npm uninstall -g @vue/cli
npm install -g @vue/cli

内容的提问来源于stack exchange，提问作者Brian