개요
.cursorignore
파일로 Cursor가 접근할 수 있는 디렉토리와 파일을 제어해.
Cursor는 .cursorignore
에 나열된 파일에 대한 접근을 다음에서 막아:
- 코드베이스 인덱싱
- Tab, Agent, Inline Edit에서 접근 가능한 코드
- @ symbol references를 통한 코드 접근
Agent가 실행하는 도구 호출(예: 터미널, MCP 서버)은
.cursorignore
로 제어되는 코드에 대한 접근을 막을 수 없어왜 파일을 무시할까?
전역 ignore 파일

- 환경 파일:
**/.env
,**/.env.*
- 자격 증명:
**/credentials.json
,**/secrets.json
- 키:
**/*.key
,**/*.pem
,**/id_rsa
.cursorignore
구성
.gitignore
문법으로 .cursorignore
파일을 만들어.
패턴 예제
계층적 무시
.cursorignore
파일을 찾으려면 Cursor Settings
> Features
> Editor
> Hierarchical Cursor Ignore
를 켜.
참고: 주석은 #
로 시작해. 나중에 나온 패턴이 이전 패턴을 덮어써. 패턴은 파일 위치를 기준으로 해.
.cursorindexingignore
로 인덱싱 제한하기
.cursorindexingignore
를 사용해 인덱싱에서만 파일을 제외해. 이 파일들은 AI 기능에선 계속 접근할 수 있지만, 코드베이스 검색에는 표시되지 않아.
기본적으로 무시되는 파일
.gitignore
와 아래 기본 무시 목록에 있는 파일을 자동으로 무시해. .cursorignore
에서 !
접두사를 붙여서 예외 처리할 수 있어.
기본 무시 목록
기본 무시 목록
인덱싱에 한해, 네
.gitignore
, .cursorignore
, .cursorindexingignore
에 있는 항목 외에도 다음 파일들이 추가로 무시돼:부정 패턴의 한계
!
로 시작)을 쓸 때, 상위 디렉터리가 *
로 제외되어 있으면 해당 파일을 다시 포함할 수 없어.
문제 해결
git check-ignore -v [file]
로 패턴을 테스트해봐.