명령줄 완성

문제 신고 소스 보기 Nightly · 8.0 . 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Bash 및 Zsh에서 명령줄 완성 (탭 완성이라고도 함)을 사용 설정할 수 있습니다. 이렇게 하면 명령어 이름, 플래그 이름 및 플래그 값, 타겟 이름을 탭하여 자동 완성할 수 있습니다.

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
```

Zsh

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
```