跳到内容

Shell 补全

如果你已全局安装 Tuist(例如通过 Homebrew),可以为 Bash 和 Zsh 安装 Shell 补全,以自动补全命令和选项。

什么是全局安装

全局安装是指安装在你的 Shell $PATH 环境变量中的安装方式。这意味着你可以在终端的任何目录下运行 tuist。这是 Homebrew 的默认安装方式。

Zsh#

如果你已安装 oh-my-zsh,你已经拥有一个会自动加载补全脚本的目录——.oh-my-zsh/completions。将新生成的补全脚本复制到该目录中名为 _tuist 的文件:

bash
tuist --generate-completion-script > ~/.oh-my-zsh/completions/_tuist

如果没有 oh-my-zsh,你需要将补全脚本的路径添加到函数路径中,并启用补全脚本的自动加载。首先,将这些行添加到 ~/.zshrc:

bash
fpath=(~/.zsh/completion $fpath)
autoload -U compinit
compinit

接下来,在 ~/.zsh/completion 创建一个目录,并将补全脚本复制到新目录中,同样保存为名为 _tuist 的文件。

bash
tuist --generate-completion-script > ~/.zsh/completion/_tuist

Bash#

如果你已安装 bash-completion,只需将新生成的补全脚本复制到文件 /usr/local/etc/bash_completion.d/_tuist:

bash
tuist --generate-completion-script > /usr/local/etc/bash_completion.d/_tuist

如果没有 bash-completion,你需要直接 source 补全脚本。将其复制到类似 ~/.bash_completions/ 的目录,然后将以下行添加到 ~/.bash_profile 或 ~/.bashrc:

bash
source ~/.bash_completions/example.bash

Fish#

如果你使用 fish shell,可以将新生成的补全脚本复制到 ~/.config/fish/completions/tuist.fish:

bash
mkdir -p ~/.config/fish/completions
tuist --generate-completion-script > ~/.config/fish/completions/tuist.fish