Mac环境Node全局包报‘Command not found’问题求助

Hey there, let's work through this frustrating issue you're having—even after adding the right paths to your $PATH, global package commands still aren't being recognized. Let's break this down step by step:

• First, make sure your PATH changes are persistent
  The export PATH=$PATH:~/bin:~/node/bin command only applies to your current terminal session. If you haven't added this line to your shell's configuration file, it'll disappear when you close or restart the terminal.

  • Check which shell you're using with echo $SHELL:
    • If it outputs /bin/zsh (default on newer Macs), edit ~/.zshrc
    • If it outputs /bin/bash, edit ~/.bash_profile or ~/.bashrc
  • Open the file with a text editor (e.g., nano ~/.zshrc), add the export line at the bottom, save and exit (for nano: Ctrl+O, Enter, Ctrl+X).
  • Reload the configuration with source ~/.zshrc (or the corresponding file for bash) and then run echo $PATH again to confirm the paths are included.

• Verify your global package directories are correct
  Sometimes the paths you're using don't match where npm/Yarn actually install global packages:

  • For npm: Run npm root -g to get the global module directory, then check its bin subfolder (e.g., if npm root -g returns ~/node/lib/node_modules, the bin path should be ~/node/bin—make sure this matches what you added to $PATH).
  • For Yarn: Run yarn global dir to get the base directory; the bin path should be $(yarn global dir)/bin—if this isn't ~/bin, you'll need to update your $PATH to use the correct path instead.

• Check directory permissions
  If your ~/bin or ~/node/bin directories don't have execute permissions, the terminal can't run the commands inside them:

  • Run ls -ld ~/bin ~/node/bin to check permissions. You should see something like drwxr-xr-x (the x means execute access).
  • If permissions are missing, fix them with chmod +x ~/bin ~/node/bin.

• Confirm the actual command files exist
  It's possible the package wasn't installed correctly, so the command file isn't in the expected directory:

  • Pick a package you tried to install (e.g., eslint) and run find ~/bin ~/node/bin -name eslint—if this returns nothing, the package didn't install properly. Try reinstalling it with npm install -g eslint or yarn global add eslint.

• Restart your terminal (or even your Mac)
  Sometimes cached shell settings can cause issues, so a full terminal restart (or system restart) can help apply the changes fully.

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