命令行补全

您可以在 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。如果您以 root 身份运行安装程序,则此路径为 /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
        

Zsh

Bazel 附带 Zsh 补全脚本。

如果您安装了 Bazel:

  • 从 APT 代码库安装,则您已完成操作,因为 Zsh 补全脚本已 安装在 /usr/share/zsh/vendor-completions 中。

    如果您对 .zshrc 进行了大量自定义,并且自动补全 功能无法正常运行,请尝试以下解决方案之一:

    将以下内容添加到 .zshrc 中:

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

    按照此处的说明操作 here

    如果您使用的是 oh-my-zsh,则可能需要安装并启用 zsh-autocomplete 插件。如果您不想这样做,请使用上述 解决方案之一。

  • 从 Homebrew 安装,则您已完成操作,因为 Zsh 补全脚本已 安装在 $(brew --prefix)/share/zsh/site-functions 中。

  • 从 GitHub 下载的安装程序安装,则:

    1. 找到补全文件的绝对路径。安装程序已将其复制到 bin 目录。

      示例:如果您使用 --user 运行安装程序,则此路径为 $HOME/.bazel/bin。如果您以 root 身份运行安装程序,则此路径为 /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