zsh自定义命令ee的环境变量补全异常：输入$后补全失效

我正在给自定义命令ee配置zsh的环境变量名补全规则，已经用compdef定义了自定义补全函数：

• 输入ee <Tab>时，补全完全正常，此时按^Xh的输出为：

  tags in context :completion::complete:ee::
      values  (_spec _echo)
  tags in context :completion::complete-fuzzy:ee::
      values  (_spec _echo)
  

• 输入不含$的任意文本后，^Xh的输出也和上述一致。

但输入ee $<Tab>时，补全器列表完全改变，^Xh输出变成：

tags in context :completion::complete-fuzzy:-parameter-::
    parameters  (_parameters _parameter autocomplete:_complete:old)
tags in context :completion::complete:-parameter-::
    parameters  (_parameters _parameter autocomplete:_complete:old)

有时还会出现更多条目：

tags in context :completion::approximate:::
    corrections original  (autocomplete:_approximate:old)
tags in context :completion::approximate-1:-parameter-::
    parameters  (_parameters _parameter autocomplete:_complete:old)
tags in context :completion::complete-fuzzy:-parameter-::
    parameters  (_parameters _parameter autocomplete:_complete:old)
tags in context :completion::complete:-parameter-::
    parameters  (_parameters _parameter autocomplete:_complete:old)
tags in context :completion::correct:::
    corrections original  (autocomplete:_approximate:old)
tags in context :completion::correct-1:-parameter-::
    parameters  (_parameters _parameter autocomplete:_complete:old)

此时自定义补全函数完全消失，想知道$为什么会影响补全行为，以及如何在输入$后仍保留自定义补全。

zsh中$是特殊触发字符，默认会触发参数补全逻辑——当输入$时，zsh会判定你需要补全shell参数（环境变量、本地变量等），此时会切换到参数补全上下文（-parameter-），不再沿用为ee命令定义的自定义补全上下文。

方法1：修改自定义补全函数，处理$前缀 #

在补全函数中先识别并处理$前缀，去掉$后用自定义候选列表，最后再把$补回候选值。示例如下：

_ee() {
    local line
    # 移除当前输入参数开头的$符号
    line=${words[CURRENT]#$}
    # 定义你的自定义补全候选（比如目标环境变量名）
    local candidates=(FOO BAR BAZ)
    # 给候选值统一添加$前缀，生成补全列表
    _describe 'environment variable' "${(@)candidates/#/$}"
}
compdef _ee ee

这样输入ee $<Tab>时，会补全$FOO、$BAR等自定义候选。

方法2：覆盖zsh参数补全上下文规则 #

通过compdef的参数优先级设置，强制ee命令的参数位置即使出现$，仍使用自定义补全函数。在zshrc中添加：

# 为ee命令的参数补全场景指定优先使用_ee函数
compdef -k _ee parameter ee

这条命令会告诉zsh，当在ee命令的参数位置处理参数补全（即输入$时），优先调用_ee而非默认参数补全器。

方法3：禁用全局自动参数补全触发（不推荐） #

如果不需要全局的$参数补全，可以调整zstyle规则，但会影响其他命令的补全行为，仅建议测试时使用：

zstyle ':completion:*' completer _complete _ignored

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