macos 配置 docker zsh 自动补全需三步：下载官方\_docker脚本至~/.zsh/completion/，在~/.zshrc中前置fpath、后执行autoload -uz compinit && compinit -i，最后source生效；文件名、路径、顺序及-compinit参数缺一不可。

macos 默认使用 zsh，配置 docker 自动补全只需三步：准备补全脚本、告知 zsh 去哪找它、初始化补全系统。关键在于脚本路径正确、文件名是 _docker（不是 docker 或 docker.txt），且 compinit 要带 -i 或 -u 参数避免权限报错。

下载并存放补全脚本

终端执行以下命令，把官方维护的 zsh 补全脚本存到本地目录：

• mkdir -p ~/.zsh/completion
• curl -L https://raw.githubusercontent.com/docker/cli/master/contrib/completion/zsh/_docker > ~/.zsh/completion/_docker

注意：链接中的仓库路径已更新为 docker/cli（非旧版 docker-ce 或 docker-archive），确保获取最新兼容版本；文件名必须是 _docker（开头下划线不能少），否则 zsh 不识别。

修改 ~/.zshrc 启用补全

用编辑器打开 ~/.zshrc，在末尾添加两行：

• fpath=(~/.zsh/completion $fpath)
• autoload -Uz compinit && compinit -i

其中 -i 参数可跳过补全脚本的文件所有权检查（macOS 上常见权限问题），比 -u 更稳妥；fpath 必须写在 compinit 之前，顺序不能颠倒。

macos-suite-readonly

macOS 只读查询：Mail 未读、Calendar 日程、Notes 搜索、Stocks 行情（输出 JSON）。

下载

生效并验证

运行以下命令立即加载新配置：

• source ~/.zshrc

然后测试：输入 docker （注意后面有空格），再按两次 Tab，应列出 build、run、ps 等子命令；输入 docker run 再按 Tab，会提示镜像名（需本地有镜像）。

如果没反应，检查 _docker 文件是否真存在于 ~/.zsh/completion/，以及 source 后有没有报 compinit: command not found —— 若有，说明 zsh 版本过低，建议通过 Homebrew 升级：brew install zsh 并设为默认 shell。