指令列完成

回報問題 查看來源

您可以在 Bash 和 Zsh 中啟用指令列完成功能 (也稱為 Tab 鍵完成功能)。這可讓您使用 Tab 鍵完成指令名稱、標記名稱和旗標值,以及目標名稱。

Bash

Bazel 隨附 Bash 完成指令碼。

如果您安裝了 Bazel:

  • 透過 APT 存放區,這樣就大功告成了,Bash 完成指令碼已安裝在 /etc/bash_completion.d 中。

  • 透過 Homebrew,這樣就大功告成了,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 build //scripts:bazel-complete.bash
      
    2. 完成檔案會在 bazel-bin/scripts/bazel-complete.bash 下建構。

      請執行下列任一步驟:

      • 如果有,請將這個檔案複製到完成目錄。

        範例:在 Ubuntu 中,這是 /etc/bash_completion.d 目錄

      • 將該檔案複製到本機磁碟的某個位置 (例如 $HOME),然後從 Bash 的 RC 檔案來源檔的來源。

        使用完成檔案絕對路徑的路徑,將類似以下的行加入 ~/.bashrc (Ubuntu) 或 ~/.bash_profile (macOS):

        source /path/to/bazel-complete.bash
        

阿什

Bazel 隨附 Zsh 完成指令碼。

如果您安裝了 Bazel:

  • 透過 APT 存放區,這樣就大功告成了,Zsh 完成指令碼已安裝在 /usr/share/zsh/vendor-completions 中。

    如果您有大幅自訂的 .zshrc,且自動完成功能無法運作,請嘗試下列其中一種解決方案:

    請將以下內容新增到您的 .zshrc 中:

        zstyle :compinstall filename '/home/tradical/.zshrc'
    
        autoload -Uz compinit
        compinit
    

    請按照這裡的指示操作

    如果您使用的是 oh-my-zsh,請安裝並啟用 zsh-autocomplete 外掛程式。如果您不想使用這項服務,請使用上述其中一種解決方案。

  • 透過 Homebrew,這樣就大功告成了,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