개요
Cursor의 Ignore Files 기능은 AI가 접근하거나 인덱싱할 파일과 폴더를 세밀하게 제어할 수 있도록 도와줍니다. 이 글에서는 Ignore Files의 개념, 설정 방법, 보안 및 성능상의 이점, 실제 사용 예시, 그리고 실무에서의 활용 팁을 단계별로 설명합니다.
Ignore Files란?
Ignore Files는 .cursorignore와 .cursorindexingignore 파일을 통해 Cursor가 특정 파일/폴더를 인덱싱하거나 AI가 접근하지 못하도록 설정하는 기능입니다. 대규모 프로젝트나 보안이 중요한 환경에서 매우 유용하게 활용할 수 있습니다.
주요 기능 및 동작 방식
- .cursorignore: AI 기능 및 인덱싱 모두에서 무시할 파일/폴더를 지정합니다.
- .cursorindexingignore: 인덱싱에서만 제외하고, AI 기능에서는 접근이 가능합니다.
- 글로벌 Ignore: 사용자 설정에서 모든 프로젝트에 적용할 Ignore 패턴을 지정할 수 있습니다.
- .gitignore 연동: 기본적으로
.gitignore에 포함된 파일도 무시합니다.
Ignore Files의 필요성
1. 보안
- API 키, 데이터베이스 비밀번호 등 민감 정보가 포함된 파일의 AI 접근을 차단할 수 있습니다.
- Cursor는 무시된 파일에 대한 접근을 최대한 차단하지만, LLM의 예측 불가성 때문에 100% 보장은 어렵습니다.
2. 성능
- 대규모 모노레포나 불필요한 파일이 많은 프로젝트에서, 인덱싱 속도와 검색 정확도를 높일 수 있습니다.
- 불필요한 파일을 제외하면 AI가 더 관련성 높은 정보를 빠르게 찾을 수 있습니다.
Ignore 파일 설정 방법
.cursorignore 기본 예시
# 특정 파일 무시
config.json
# 디렉토리 전체 무시
dist/
# 확장자별 무시
*.log고급 패턴 예시
# 전체 코드베이스 무시
*
# app 디렉토리는 무시하지 않음
!app/
# 모든 logs 디렉토리 무시
**/logs- 빈 줄과
#로 시작하는 주석은 무시됩니다. - 패턴은
.gitignore와 동일하게 동작합니다. - 상위 디렉토리까지
.cursorignore를 계층적으로 적용할 수도 있습니다.
.cursorindexingignore
- 인덱싱에서만 제외하고, AI 기능에서는 접근이 필요한 경우 사용합니다.
- 예: 빌드 산출물은 인덱싱에서 제외하지만, 코드 검색에는 필요할 때 활용
기본적으로 무시되는 파일
.gitignore에 포함된 파일- Cursor의 기본 Ignore 리스트(잠금 파일, 바이너리, 이미지, 대용량 데이터 등)
- 무시된 파일을 다시 포함하려면
!접두어를 사용합니다.
실무 활용 팁
- 보안이 중요한 파일은 반드시
.cursorignore에 추가하세요. - 대규모 프로젝트에서는 불필요한 폴더/파일을 적극적으로 무시해 인덱싱 속도를 높이세요.
- 패턴이 잘 동작하는지
git check-ignore -v [file]로 테스트할 수 있습니다.
참고 자료
반응형
