M1 Mac ZSH配置alias失效，提示_brew_cask文件缺失求助

问题描述 #

• 在M1 MacBook Pro的zsh中配置alias后写入~/.zshrc不生效
• 执行source ~/.zshrc时终端报错：

  compinit:503: no such file or directory: /usr/local/share/zsh/site-functions/_brew_cask
  

• 已尝试方案：brew doctor、brew cleanup、brew install zsh-completions，并在source $ZSH/oh-my-zsh.sh前添加配置：

  HOMEBREW_PREFIX=$(brew --prefix)
  export FPATH="${HOMEBREW_PREFIX}/share/zsh/site-functions:${FPATH}"
  

• 执行brew --prefix返回/usr/local，完整~/.zshrc内容如下：

# Enable Powerlevel10k instant prompt. Should stay close to the top of ~/.zshrc.
# Initialization code that may require console input (password prompts, [y/n]
# confirmations, etc.) must go above this block; everything else may go below.
if [[ -r "${XDG_CACHE_HOME:-$HOME/.cache}/p10k-instant-prompt-${(%):-%n}.zsh" ]]; then
  source "${XDG_CACHE_HOME:-$HOME/.cache}/p10k-instant-prompt-${(%):-%n}.zsh"
fi

# If you come from bash you might have to change your $PATH.
# export PATH=$HOME/bin:/usr/local/bin:$PATH

# Path to your oh-my-zsh installation.
export ZSH=$HOME/.oh-my-zsh

# Set name of the theme to load --- if set to "random", it will
# load a random theme each time oh-my-zsh is loaded, in which case,
# to know which specific one was loaded, run: echo $RANDOM_THEME
# See https://github.com/ohmyzsh/ohmyzsh/wiki/Themes
ZSH_THEME="powerlevel10k/powerlevel10k"

# Set list of themes to pick from when loading at random
# Setting this variable when ZSH_THEME=random will cause zsh to load
# a theme from this variable instead of looking in $ZSH/themes/
# If set to an empty array, this variable will have no effect.
# ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster" )

# Uncomment the following line to use case-sensitive completion.
# CASE_SENSITIVE="true"

# Uncomment the following line to use hyphen-insensitive completion.
# Case-sensitive completion must be off. _ and - will be interchangeable.
# HYPHEN_INSENSITIVE="true"

# Uncomment one of the following lines to change the auto-update behavior
# zstyle ':omz:update' mode disabled  # disable automatic updates
# zstyle ':omz:update' mode auto      # update automatically without asking
# zstyle ':omz:update' mode reminder  # just remind me to update when it's time

# Uncomment the following line to change how often to auto-update (in days).
# zstyle ':omz:update' frequency 13

# Uncomment the following line if pasting URLs and other text is messed up.
# DISABLE_MAGIC_FUNCTIONS="true"

# Uncomment the following line to disable colors in ls.
# DISABLE_LS_COLORS="true"

# Uncomment the following line to disable auto-setting terminal title.
# DISABLE_AUTO_TITLE="true"

# Uncomment the following line to enable command auto-correction.
# ENABLE_CORRECTION="true"

# Uncomment the following line to display red dots whilst waiting for completion.
# You can also set it to another string to have that shown instead of the default red dots.
# e.g. COMPLETION_WAITING_DOTS="%F{yellow}waiting...%f"
# Caution: this setting can cause issues with multiline prompts in zsh < 5.7.1 (see #5765)
# COMPLETION_WAITING_DOTS="true"

# Uncomment the following line if you want to disable marking untracked files
# under VCS as dirty. This makes repository status check for large repositories
# much, much faster.
# DISABLE_UNTRACKED_FILES_DIRTY="true"

# Uncomment the following line if you want to change the command execution time
# stamp shown in the history command output.
# You can set one of the optional three formats:
# "mm/dd/yyyy"|"dd.mm.yyyy"|"yyyy-mm-dd"
# or set a custom format using the strftime function format specifications,
# see 'man strftime' for details.
# HIST_STAMPS="mm/dd/yyyy"

# Would you like to use another custom folder than $ZSH/custom?
# ZSH_CUSTOM=/path/to/new-custom-folder

# Which plugins would you like to load?
# Standard plugins can be found in $ZSH/plugins/
# Custom plugins may be added to $ZSH_CUSTOM/plugins/
# Example format: plugins=(rails git textmate ruby lighthouse)
# Add wisely, as too many plugins slow down shell startup.
plugins=(
     git
     zsh-interactive-cd
     zsh-navigation-tools
     zsh-autosuggestions
     zsh-syntax-highlighting
)

HOMEBREW_PREFIX=$(brew --prefix)
export FPATH="${HOMEBREW_PREFIX}/share/zsh/site-functions:${FPATH}"

source $ZSH/oh-my-zsh.sh

# User configuration

# export MANPATH="/usr/local/man:$MANPATH"

# You may need to manually set your language environment
# export LANG=en_US.UTF-8

# Preferred editor for local and remote sessions
# if [[ -n $SSH_CONNECTION ]]; then
#   export EDITOR='vim'
# else
#   export EDITOR='mvim'
# fi

# Compilation flags
# export ARCHFLAGS="-arch x86_64"

# Set personal aliases, overriding those provided by oh-my-zsh libs,
# plugins, and themes. Aliases can be placed here, though oh-my-zsh
# users are encouraged to define aliases within the ZSH_CUSTOM folder.
# For a full list of active aliases, run `alias`.
#
# Example aliases
# alias zshconfig="mate ~/.zshrc"
# alias ohmyzsh="mate ~/.oh-my-zsh"

# To customize prompt, run `p10k configure` or edit ~/.p10k.zsh.
[[ ! -f ~/.p10k.zsh ]] || source ~/.p10k.zsh

解决方案 #

针对M1芯片架构特殊性，按以下步骤尝试：

1. 重新生成brew cask补全文件 #

执行命令强制重新安装brew cask的zsh补全组件：

brew reinstall brew-cask-completion

若提示组件不存在，改用：

brew reinstall homebrew/completions/brew-cask-completion

2. 调整FPATH顺序并清理补全缓存 #

• 打开~/.zshrc，将FPATH配置移到Powerlevel10k即时提示代码块之后、其他配置之前，确保brew补全文件优先加载：

  HOMEBREW_PREFIX=$(brew --prefix)
  export FPATH="${HOMEBREW_PREFIX}/share/zsh/site-functions:${FPATH}"
  

• 删除zsh的旧补全缓存文件：

  rm -f ~/.zcompdump*
  

• 重新加载配置：

  source ~/.zshrc
  

3. 适配M1架构的brew路径 #

你的brew安装在/usr/local（x86版本），尝试以下操作：

• 右键终端图标，选择「使用Rosetta打开」，再执行source ~/.zshrc测试
• 若想改用ARM原生brew，重新安装后（默认路径/opt/homebrew），更新~/.zshrc中的FPATH配置，重新加载即可

4. 确认alias配置位置 #

将自定义alias写在source $ZSH/oh-my-zsh.sh之后，避免被oh-my-zsh默认配置覆盖，例如在文件末尾添加：

# 自定义alias示例
alias ll='ls -alF'
alias gs='git status'

验证方法 #

执行命令确认补全文件存在：

ls -la /usr/local/share/zsh/site-functions/_brew_cask

若输出文件信息，再执行source ~/.zshrc，无报错且alias命令能列出自定义alias，说明问题解决。

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