본문으로 건너뛰기

Cursor에서 민감한 파일을 무시하는 방법

Cursor는 기본적으로 프로젝트의 모든 파일을 인덱싱하고 분석합니다. 하지만 때로는 특정 파일이나 디렉토리를 인덱싱에서 제외하고 싶을 수 있습니다. 예를 들어:

  • 민감한 정보가 포함된 파일
  • 대용량 데이터 파일
  • 임시 파일이나 빌드 아티팩트
  • 외부 라이브러리나 의존성

이러한 파일들을 Cursor의 인덱싱에서 제외하는 방법을 알아보겠습니다.

.cursorignore 파일 사용하기​

Cursor는 .cursorignore 파일을 통해 특정 파일이나 디렉토리를 무시할 수 있습니다. 이는 .gitignore와 유사한 방식으로 작동합니다.

  1. 프로젝트의 루트 디렉토리에 .cursorignore 파일을 생성합니다.
  2. 무시하고 싶은 파일이나 디렉토리 패턴을 한 줄에 하나씩 추가합니다.

예시:

# 민감한 환경 설정 파일
.env
.env.local
secrets.json

# 대용량 데이터 디렉토리
data/
datasets/

# 빌드 출력물
dist/
build/
*.pyc

# 의존성
node_modules/
vendor/

패턴 매칭 규칙​

.cursorignore는 .gitignore와 동일한 패턴 매칭 규칙을 따릅니다:

  • #로 시작하는 줄은 주석으로 처리됩니다
  • 슬래시(/)로 시작하는 패턴은 프로젝트 루트 디렉토리부터 매칭됩니다
  • 디렉토리는 슬래시(/)로 끝납니다
  • 느낌표(!)로 시작하는 패턴은 이전에 무시된 파일을 다시 포함시킵니다
  • *, ?, [abc]와 같은 글로브 패턴을 사용할 수 있습니다

모범 사례​

다음은 .cursorignore 파일 사용에 대한 몇 가지 권장 사항입니다:

  1. 프로젝트 시작 시 설정: 프로젝트를 시작할 때 .cursorignore 파일을 만들어 민감한 파일이 실수로 인덱싱되는 것을 방지하세요.

  2. 팀과 공유: .cursorignore 파일을 버전 관리에 포함시켜 팀원 모두가 동일한 파일을 무시하도록 하세요.

  3. 정기적으로 검토: 프로젝트가 발전함에 따라 .cursorignore 파일을 주기적으로 검토하고 업데이트하세요.

  4. 문서화: 왜 특정 파일이나 디렉토리를 무시하는지 주석으로 설명하세요.

주의사항​

  • .cursorignore 파일을 변경한 후에는 Cursor를 재시작해야 변경사항이 적용됩니다.
  • 이미 인덱싱된 파일을 무시하려면, 해당 파일을 삭제하고 Cursor를 재시작해야 할 수 있습니다.
  • 너무 많은 파일을 무시하면 Cursor의 코드 이해 및 자동완성 기능이 제한될 수 있습니다.