M1 Mac Mini安装Ionic CLI失败：安装后无法识别ionic命令

问题原因 #

npm全局安装的Ionic CLI可执行文件所在目录未被添加到zsh的环境变量PATH中，导致终端找不到ionic命令。安装时的废弃包警告属于正常依赖提示，不影响功能使用。

解决方案 #

• 步骤1：确认npm全局包的bin目录路径
  执行以下命令获取npm全局包的根路径：

  npm get prefix
  

  返回结果类似/usr/local、/opt/homebrew（M1芯片Homebrew默认路径）或~/.npm-global，对应的可执行文件目录为[返回路径]/bin（例如/usr/local/bin）。

• 步骤2：检查目录是否在PATH中
  执行命令查看当前环境变量：

  echo $PATH
  

  如果步骤1得到的bin目录不在输出结果中，需要手动添加。

• 步骤3：添加目录到zsh配置文件
  编辑zsh的配置文件~/.zshrc：

  open -e ~/.zshrc
  

  在文件末尾添加一行（替换成你实际的bin目录路径）：

  export PATH="/usr/local/bin:$PATH"
  

  如果你的路径是/opt/homebrew/bin，则改为：

  export PATH="/opt/homebrew/bin:$PATH"
  

  如果是~/.npm-global/bin，则改为：

  export PATH="$HOME/.npm-global/bin:$PATH"
  

• 步骤4：使配置生效
  执行命令让修改的配置立即生效：

  source ~/.zshrc
  

• 步骤5：验证解决效果
  再次执行以下命令，确认ionic命令可正常识别：

  ionic -v
  

备选方案（避免sudo权限问题） #

如果使用sudo安装导致路径或权限异常，可改用用户目录安装：

• 配置npm全局包路径到用户目录：

  npm config set prefix '~/.npm-global'
  

• 按照上述步骤3将~/.npm-global/bin添加到~/.zshrc的PATH中，执行source ~/.zshrc生效。
• 无需sudo，直接安装Ionic CLI：

  npm i -g @ionic/cli
  

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