指令列完成

您可以在 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