​
개요

Cursor는 프로젝트의 코드베이스를 읽고 인덱싱하여 기능을 구동합니다. 루트 디렉토리에 .cursorignore 파일을 사용하여 Cursor가 액세스할 수 있는 디렉토리와 파일을 제어하세요. Cursor는 .cursorignore에 나열된 파일에 대한 다음 액세스를 차단합니다:
터미널 및 MCP 서버와 같이 Agent에 의해 시작된 도구 호출은 .cursorignore에 의해 관리되는 코드에 대한 액세스를 차단할 수 없습니다

​
파일을 무시하는 이유는?

보안: API 키, 자격 증명, 비밀 정보에 대한 접근을 제한합니다. Cursor가 무시된 파일을 차단하지만, LLM의 예측 불가능성으로 인해 완전한 보호가 보장되지는 않습니다. 성능: 대규모 코드베이스나 모노레포에서 관련 없는 부분을 제외하여 더 빠른 인덱싱과 더 정확한 파일 검색을 가능하게 합니다.

​
전역 무시 파일

사용자 설정에서 모든 프로젝트에 대한 무시 패턴을 설정하여 프로젝트별 구성 없이 민감한 파일을 제외할 수 있습니다.
Global Cursor Ignore List
기본 패턴에는 다음이 포함됩니다:
  • 환경 파일: **/.env, **/.env.*
  • 자격 증명: **/credentials.json, **/secrets.json
  • 키: **/*.key, **/*.pem, **/id_rsa

​
.cursorignore 구성하기

.gitignore 구문을 사용하여 루트 디렉토리에 .cursorignore 파일을 생성하세요.

​
패턴 예시

config.json      # 특정 파일
dist/           # 디렉토리
*.log           # 파일 확장자
**/logs         # 중첩된 디렉토리
!app/           # 무시에서 제외 (부정)

​
계층적 무시

Cursor Settings > Features > Editor > Hierarchical Cursor Ignore를 활성화하여 상위 디렉토리에서 .cursorignore 파일을 검색하세요. 참고: 주석은 #로 시작합니다. 나중 패턴이 이전 패턴을 재정의합니다. 패턴은 파일 위치를 기준으로 상대적입니다.

​
.cursorindexingignore로 인덱싱 제한하기

.cursorindexingignore를 사용하여 인덱싱에서만 파일을 제외하세요. 이러한 파일들은 AI 기능에서는 여전히 접근 가능하지만 코드베이스 검색에는 나타나지 않습니다.

​
기본적으로 무시되는 파일

Cursor는 .gitignore와 아래의 기본 무시 목록에 있는 파일들을 자동으로 무시합니다. .cursorignore에서 ! 접두사로 재정의할 수 있습니다.

​
부정 패턴 제한사항

부정 패턴(! 접두사 사용)을 사용할 때, 상위 디렉토리가 *를 통해 제외된 경우 파일을 다시 포함시킬 수 없습니다. 
# public 폴더의 모든 파일 무시
public/*

# ✅ 이것은 작동합니다. 파일이 최상위 레벨에 존재하기 때문입니다
!public/index.html

# ❌ 이것은 작동하지 않습니다 - 중첩된 디렉토리의 파일을 다시 포함시킬 수 없습니다
!public/assets/style.css
해결방법: 중첩된 디렉토리를 명시적으로 제외하세요: 
public/assets/*
!public/assets/style.css # 이 파일은 이제 접근 가능합니다
제외된 디렉토리는 성능상의 이유로 탐색되지 않으므로, 포함된 파일에 대한 패턴은 효과가 없습니다. 이는 중첩된 디렉토리의 부정 패턴에 대한 .gitignore 구현과 일치합니다. 자세한 내용은 gitignore 패턴에 대한 공식 Git 문서를 참조하세요.

​
문제 해결

git check-ignore -v [file]로 패턴을 테스트하세요.