completion

자동 완성을 설정하면 터미널에서 입력 중 <TAB> 키를 눌렀을 때 사용할 수 있는 여러 명령과 옵션이 표시됩니다. 명령을 많이 외우지 않고도 CLI 명령을 쉽게 찾고 사용할 수 있습니다.

자동 설정

CLI를 처음 사용할 때(v14 이상) 자동 완성을 설정할지 묻는 프롬프트가 표시됩니다. "Yes"라고 응답하면 나머지는 CLI가 처리합니다.

$ ng serve
? Would you like to enable autocompletion? This will set up your terminal so pressing TAB while typing Angular CLI commands will show possible options and autocomplete arguments. (Enabling autocompletion will modify configuration files in your home directory.) Yes
Appended `source <(ng completion script)` to `/home/my-username/.bashrc`. Restart your terminal or run:

source <(ng completion script)

to autocomplete `ng` commands.

# Serve output...

이전에 프롬프트를 거절했다면 다시 묻지 않습니다. 하지만 ng completion을 실행하면 같은 설정을 자동으로 수행할 수 있습니다.

이 명령은 Angular CLI 자동 완성을 로드하도록 터미널 환경을 변경하지만, 현재 터미널 세션은 갱신할 수 없습니다. 터미널을 다시 시작하거나 source <(ng completion script)를 직접 실행하면 현재 세션에서 자동 완성을 활성화할 수 있습니다.

ng ser<TAB>을 입력해서 ng serve로 자동 완성되는지 확인하세요. ng generate <TAB>처럼 인수가 명확하지 않으면 가능한 모든 옵션과 해당 문서가 표시됩니다.

수동 설정

터미널 설정을 많이 수정해서 사용하거나 특정 구조의 설정 파일을 소스 관리에 포함하는 사용자도 있습니다. ng completion은 현재 셸의 기존 설정 파일에 Angular 설정을 추가하기만 하며, 파일이 없으면 새로 생성합니다. 설정을 저장할 위치를 더 세밀하게 제어하려면 셸 시작 시 다음 코드를 실행하도록 직접 설정할 수 있습니다:

if [[ $- == *i* ]]; then
  source <(ng completion script)
fi

이는 ng completion이 자동으로 구성하는 것과 동일하며, 필요한 경우 숙련된 사용자가 환경을 더 유연하게 구성할 수 있습니다.

플랫폼 지원

Angular CLI는 macOS와 Linux 운영체제에서 Bash와 Zsh 셸의 자동 완성을 지원합니다. Windows에서는 Git Bash와 Bash 또는 Zsh를 사용하는 Windows Subsystem for Linux를 지원합니다.

전역 설치

자동 완성은 터미널 시작 시 Angular CLI를 호출해 설정 스크립트를 로드하도록 구성하는 방식으로 동작합니다. 따라서 터미널에서 Angular CLI를 찾고 실행할 수 있어야 하며, 일반적으로 전역 설치를 통해 사용자의 $PATH에 실행 파일을 배치합니다. command not found: ng가 표시되면 CLI가 전역으로 설치되어 있는지 확인하세요. -g 플래그로 전역 설치할 수 있습니다:

npm install -g @angular/cli