파일 무시하기

이 문서는 Gemini CLI의 Gemini Ignore (.geminiignore) 기능에 대한 개요를 제공합니다.

Gemini CLI에는 .gitignore(Git에서 사용) 및 .aiexclude(Gemini Code Assist에서 사용)와 유사하게 파일을 자동으로 무시하는 기능이 포함되어 있습니다. .geminiignore 파일에 경로를 추가하면 이 기능을 지원하는 도구에서 해당 경로가 제외되지만, 다른 서비스(예: Git)에는 여전히 표시됩니다.

작동 방식

.geminiignore 파일에 경로를 추가하면 이 파일을 준수하는 도구는 해당 파일과 디렉토리를 작업에서 제외합니다. 예를 들어 @ 명령을 사용하여 파일을 공유할 때 .geminiignore 파일의 모든 경로는 자동으로 제외됩니다.

대부분의 경우 .geminiignore는 .gitignore 파일의 규칙을 따릅니다:

• 빈 줄과 #으로 시작하는 줄은 무시됩니다.
• 표준 glob 패턴이 지원됩니다 (예: *, ?, []).
• 끝에 /를 넣으면 디렉토리만 일치합니다.
• 시작 부분에 /를 넣으면 .geminiignore 파일을 기준으로 경로를 고정합니다.
• !는 패턴을 부정합니다.

언제든지 .geminiignore 파일을 업데이트할 수 있습니다. 변경 사항을 적용하려면 Gemini CLI 세션을 다시 시작해야 합니다.

.geminiignore 사용 방법

.geminiignore를 활성화하려면:

1. 프로젝트 디렉토리의 루트에 .geminiignore라는 파일을 만듭니다.

파일이나 디렉토리를 .geminiignore에 추가하려면:

1. .geminiignore 파일을 엽니다.
2. 무시할 경로 또는 파일을 추가합니다. 예: /archive/ 또는 apikeys.txt.

.geminiignore 예제

.geminiignore를 사용하여 디렉토리와 파일을 무시할 수 있습니다:

# /packages/ 디렉토리와 모든 하위 디렉토리 제외
/packages/

# apikeys.txt 파일 제외
apikeys.txt

.geminiignore 파일에서 *와 함께 와일드카드를 사용할 수 있습니다:

# 모든 .md 파일 제외
*.md

마지막으로 !를 사용하여 파일과 디렉토리를 제외 대상에서 제외할 수 있습니다:

# README.md를 제외한 모든 .md 파일 제외
*.md
!README.md

.geminiignore 파일에서 경로를 제거하려면 관련 줄을 삭제하세요.