Mac上Neovim安装问题：命令失效及干净安装需求

1. 解决Homebrew ARM处理器安装报错 #

你遇到的错误是因为M系列ARM Mac有两个Homebrew默认前缀：

• Intel架构：/usr/local
• ARM架构：/opt/homebrew

默认情况下M系列Mac终端是ARM模式，需使用对应架构的Homebrew：

• 若不需要保留Intel版Homebrew，先卸载残留：

  /usr/local/bin/brew uninstall --force --ignore-dependencies neovim
  /usr/local/bin/brew uninstall --force brew
  rm -rf /usr/local/Homebrew
  

• 重新安装ARM版Homebrew：

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  

• 确保ARM版Homebrew路径在PATH最前，编辑~/.zshrc或~/.bashrc添加：

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

• 重启终端后执行brew install neovim即可正常安装。

2. 全新干净卸载Neovim的所有文件 #

彻底清除所有安装痕迹，删除以下文件/文件夹：

• 手动解压的文件夹：直接删除主目录下的两个nvim-macos文件夹
• 配置目录：~/.config/nvim（注意是小写，你之前删除的Nvim可能是大小写错误）
• 用户数据目录：~/.local/share/nvim
• 缓存目录：~/.cache/nvim
• Homebrew残留（若之前用brew安装过）：

  # ARM版Homebrew执行
  brew uninstall neovim
  # Intel版残留执行
  arch -x86_64 brew uninstall neovim
  

• 全局二进制文件：检查并删除可能存在的链接：

  rm -f /usr/local/bin/nvim /opt/homebrew/bin/nvim
  

3. 手动安装后让nvim命令全局可用 #

手动解压的Neovim无法直接用nvim启动，是因为其bin目录不在系统PATH中，两种解决方法任选：

• 方法一：创建全局软链接（推荐）
  保留一个干净的nvim-macos文件夹（比如移到~/Applications），执行：

  sudo ln -s ~/Applications/nvim-macos/bin/nvim /opt/homebrew/bin/nvim
  

  重启终端后即可用nvim命令启动。
• 方法二：将bin目录加入PATH
  编辑~/.zshrc或~/.bashrc添加：

  export PATH="$HOME/nvim-macos/bin:$PATH"
  

  执行source ~/.zshrc（对应你的终端配置文件）后，nvim命令即可全局使用。

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