본문으로 건너뛰기

코드베이스 읽기 문제 해결

정보

Cursor가 코드베이스나 파일을 읽는 데 문제가 있다면 이 가이드를 따라 일반적인 문제를 해결하세요.

일반적인 증상​

  1. Cursor가 프로젝트 파일을 볼 수 없음
  2. AI 기능이 코드베이스와 작동하지 않음
  3. 파일 트리가 업데이트되지 않음
  4. 검색 기능이 작동하지 않음

빠른 해결책​

1. 파일 트리 새로고침​

가장 빠른 해결책은 종종 파일 트리를 새로고침하는 것입니다:

  1. 파일 탐색기에서 마우스 오른쪽 버튼 클릭
  2. "새로고침" 선택
  3. 파일 트리가 업데이트될 때까지 기다림

2. 파일 권한 확인​

  1. 프로젝트 폴더에서 마우스 오른쪽 버튼 클릭
  2. "속성" 선택
  3. "보안" 탭으로 이동
  4. 사용자에게 "읽기" 및 "쓰기" 권한이 있는지 확인

3. .gitignore 및 .cursorignore 확인​

때로는 파일이 의도적으로 무시됩니다. 다음을 확인하세요:

  1. .gitignore 파일 내용
  2. .cursorignore 파일 내용
  3. 무시되지 않아야 할 패턴 제거

심층 해결책​

파일 시스템 감시자 문제​

Cursor가 파일 변경을 감지하지 못하는 경우:

.vscode/settings.json
{
  "files.watcherExclude": {
    "**/node_modules/**": true,
    "**/dist/**": true,
    // 제외하려는 다른 디렉토리 추가
  }
}

대규모 코드베이스 처리​

대규모 코드베이스의 경우:

  1. 메모리 제한 증가

    .cursor/settings.json
    {
      "files.maxMemoryForLargeFilesMB": 4096
    }

  2. 파일 감시 최적화

    • 불필요한 디렉토리 제외
    • 작업 공간 신뢰 기능 사용
    • 작업 공간 스토리지 사용 고려

Git 통합 문제​

Git 관련 기능이 작동하지 않는 경우:

  1. Git 설치 확인:

    git --version

  2. Git 구성 확인:

    git config --list

  3. Git 캐시 재설정:

    git rm -r --cached .
    git add .

예방 팁​

  1. 깔끔한 프로젝트 구조

    • 파일을 논리적으로 구성
    • 적절한 .gitignore 사용
    • 루트 디렉토리 깔끔하게 유지

  2. 정기적인 유지 관리

    • 편집기 캐시 정기적으로 지우기
    • Cursor 자주 업데이트
    • 시스템 리소스 모니터링

  3. 성능 최적화

    • 큰 바이너리 파일 제외
    • 작업 공간 스토리지 사용
    • 적절한 무시 패턴 구현

고급 문제 해결​

로깅 및 진단​

상세 로깅 활성화:

  1. 명령 팔레트 열기(Ctrl/Cmd + Shift + P)
  2. "Developer: Set Log Level" 입력
  3. "Trace" 선택

캐시 재설정​

문제가 지속되는 경우:

  1. Cursor 닫기
  2. 캐시 디렉토리 삭제:
    • Windows: %APPDATA%\Cursor\Cache
    • macOS: ~/Library/Application Support/Cursor/Cache
    • Linux: ~/.config/Cursor/Cache
  3. Cursor 재시작

작업 공간 신뢰​

작업 공간 신뢰 구성:

  1. 명령 팔레트 열기
  2. "Workspace Trust" 검색
  3. 프로젝트에 대한 신뢰 설정 구성

지원팀에 문의해야 할 때​

다음과 같은 경우 Cursor 지원팀에 문의하세요:

  1. 모든 해결책을 시도한 후에도 문제가 지속됨
  2. 데이터 손실이 발생함
  3. 성능이 크게 저하됨
  4. 보안 문제가 발견됨
팁

지원팀에 문의할 때 오류 로그와 시스템 정보를 준비해 두세요

관련 리소스​