gcloud CLI 自動完成功能

本頁面提供相關操作說明，協助您設定及使用 gdcloud CLI 自動完成功能，只要按下 Tab 鍵，即可完成部分輸入的指令。這項功能適用於 Bash、Zsh 和 Fish 殼層。 gdcloud CLI 自動完成功能會在您輸入指令和選項時提供建議。如果您不確定要使用哪個指令，或是想使用從未用過的指令，這項功能就非常實用。

啟用自動完成功能

如要啟用自動完成功能，請在終端機中執行指令。gdcloud CLI 自動完成功能適用於 Linux 作業系統的 Bash、Zsh 和 Fish 殼層。使用下列指令找出您使用的殼層。

echo $SHELL

輸出內容看起來會像 bin/$SHELL，其中 $SHELL 是 bash、zsh 或 fish。

Bash

如要在目前的 Shell 工作階段中載入自動完成功能：

source <(gdcloud completion bash)

如要為每個新工作階段載入完成項目，請執行一次：

gdcloud completion bash > /etc/bash_completion.d/gdcloud

Zsh

如果環境中尚未啟用 Shell 自動完成功能，請務必啟用。檢查是否已啟用 Shell 完成功能。

檢查 COMP_LINE 變數的值。如果 COMP_LINE 變數的值為空白，則不會啟用殼層完成功能。您可以執行下列指令來檢查這個值：

echo $COMP_LINE

嘗試使用指令完成功能。如果您嘗試使用指令的殼層完成功能，但無法運作，表示殼層完成功能未啟用。舉例來說，請嘗試輸入下列指令，然後按下 Tab 鍵。如果已啟用 Shell 完成功能，您應該會看到 ls 指令的可能完成清單。

ls

檢查 compgen -c 指令的輸出內容。如果 compgen -c 指令的輸出內容不含任何指令，表示未啟用 Shell 完成功能。您可以執行下列指令，查看 compgen -c 指令的輸出內容。如果已啟用 Shell 補完功能，指令輸出內容應會列出具有補完功能的指令。

compgen -c

如果不確定環境是否已啟用 Shell 自動完成功能，請參閱 Shell 的說明文件。 如果環境未啟用殼層完成功能，請執行下列指令來啟用：

echo "autoload -U compinit; compinit" >> ~/.zshrc

如要在目前的 Shell 工作階段中載入自動完成功能：

source <(gdcloud completion zsh); compdef _gdcloud gdcloud

如要載入每個工作階段的完成事項，請執行一次：

gdcloud completion zsh > "${fpath[1]}/_gdcloud"

您必須啟動新的殼層，這項設定才會生效。

魚

如要在目前的 Shell 工作階段中載入自動完成功能：

gdcloud completion fish | source

如要載入每個工作階段的完成項目，請執行下列指令：

gdcloud completion fish > ~/.config/fish/completions/gdcloud.fish

您必須啟動新的殼層，這項設定才會生效。

使用自動完成功能

如要使用 gdcloud CLI 自動完成功能，請輸入要使用的指令前幾個字元，然後按下 Tab 鍵。如果只有一個可能的完成項目，系統會自動插入指令列。如果指令未自動填入，表示有多個可能的完成項目，您必須再次按下 Tab 鍵，才能查看所有可能的指令。

自動完成範例

輸入部分指令，然後按下 Tab 鍵，即可自動完成指令：

gdcloud con <TAB>

按下 Tab 鍵一次後完成的指令：

gdcloud config

輸入部分指令，然後按兩次 Tab 鍵，即可查看所有可能的指令：

gdcloud clusters <TAB> <TAB>
describe get-credentials list
gdcloud clusters