指令列完成

回報問題查看來源 Nightly · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

您可以在 Bash 和 Zsh 中啟用指令列完成功能 (也稱為 Tab 鍵完成功能)。這樣一來，您就能使用 Tab 鍵自動完成指令名稱、旗標名稱和旗標值，以及目標名稱。

Bash

Bazel 隨附 Bash 完成指令碼。

如果您已安裝 Bazel：

這樣就完成了，Bash 完成指令碼已安裝在 /etc/bash_completion.d 中。
這樣就完成了，Bash 完成指令碼已安裝在 $(brew --prefix)/etc/bash_completion.d 中。
從 GitHub 下載安裝程式，然後：
1. 找出完成檔案的絕對路徑。安裝程式已將其複製到 bin 目錄。
  
  舉例來說，如果您使用 --user 執行安裝程式，這個值會是 $HOME/.bazel/bin。如果您以根目錄身分執行安裝程式，這個值會是 /usr/local/lib/bazel/bin。
2. 請執行下列任一步驟：
  - 將這個檔案複製到完成目錄 (如有)。
    
    舉例來說，在 Ubuntu 中，這是 /etc/bash_completion.d 目錄。
  - 或者，從 Bash 的 RC 檔案取得完成檔案。
    
    在 ~/.bashrc (Ubuntu) 或 ~/.bash_profile (macOS) 中新增類似下方的行，並使用完成檔案的絕對路徑：
```
source /path/to/bazel-complete.bash
```
透過啟動程序，然後：
1. 將完成指令碼發出至檔案：
```
bazel help completion bash > bazel-complete.bash
```
2. 請執行下列任一步驟：
  - 將這個檔案複製到完成目錄 (如有)。
    
    範例：在 Ubuntu 中，這是 /etc/bash_completion.d 目錄
  - 將其複製到本機磁碟的某個位置 (例如 $HOME)，然後從 Bash 的 RC 檔案中取得完成檔案的來源。
    
    在 ~/.bashrc (Ubuntu) 或 ~/.bash_profile (macOS) 中新增類似下方的行，並使用完成檔案的絕對路徑：
```
source /path/to/bazel-complete.bash
```

Zsh

Bazel 隨附 Zsh 完成指令碼。

如果您已安裝 Bazel：

這樣就完成了，Zsh 完成指令碼已安裝在 /usr/share/zsh/vendor-completions 中。
如果您的 .zshrc 經過大幅自訂，且自動完成功能無法運作，請嘗試下列其中一種解決方案：

請將以下內容新增到 .zshrc：
```
    zstyle :compinstall filename '/home/tradical/.zshrc'

    autoload -Uz compinit
    compinit
```
或

請按照這裡的指示操作

如果您使用 oh-my-zsh，可能需要安裝並啟用 zsh-autocomplete 外掛程式。如不想這麼做，請使用上述其中一種解決方案。
這樣就完成了，Zsh 完成指令碼已安裝在 $(brew --prefix)/share/zsh/site-functions 中。
從 GitHub 下載安裝程式，然後：
1. 找出完成檔案的絕對路徑。安裝程式已將其複製到 bin 目錄。
  
  舉例來說，如果您使用 --user 執行安裝程式，這個值會是 $HOME/.bazel/bin。如果您以根目錄身分執行安裝程式，這個值會是 /usr/local/lib/bazel/bin。
2. 將這個指令碼新增至 $fpath 的目錄：
```
fpath[1,0]=~/.zsh/completion/
mkdir -p ~/.zsh/completion/
cp /path/from/above/step/_bazel ~/.zsh/completion
```
  您可能必須先呼叫 rm -f ~/.zcompdump; compinit，才能讓這項功能正常運作。
3. 視需要將下列項目新增至 .zshrc。
```
# This way the completion script does not have to parse Bazel's options
# repeatedly.  The directory in cache-path must be created manually.
zstyle ':completion:*' use-cache on
zstyle ':completion:*' cache-path ~/.zsh/cache
```