Skip to content

일반적인 문제

이 가이드는 사용자들이 Sidian에서 가장 흔하게 겪는 문제들을 다루고, 이를 신속하게 해결하기 위한 단계별 해결책을 제공합니다.

AI 기능이 작동하지 않을 때

Sidian의 AI 기능이 응답하지 않거나 제대로 작동하지 않는 경우:

인증 문제

AI 기능은 인증이 필요합니다

  • 로그인되어 있는지 확인하세요 (사이드바에서 계정 상태 확인)
  • 로그아웃 후 다시 로그인해 보세요
  • 구독이 활성 상태인지 확인하세요
  • 웹 인증을 사용하는 경우 브라우저 캐시를 지우세요

네트워크 연결

클라우드 AI 모델은 인터넷 연결이 필요합니다

  • 클라우드 모델의 경우: 인터넷 연결을 확인하세요
  • 로컬 모델의 경우: 로컬 AI 서버(Ollama/LM Studio)가 실행 중인지 확인하세요
  • 방화벽이 Sidian을 차단하고 있지 않은지 확인하세요
  • 클라우드 모델을 사용하는 경우 VPN을 일시적으로 비활성화해 보세요
  • 회사 프록시가 방해하고 있는지 확인하세요

구성 문제

AI 모델 및 공급자 설정을 확인하세요

  • API 키가 올바르게 구성되었는지 확인하세요
  • 선택한 AI 모델을 사용할 수 있는지 확인하세요
  • 다른 AI 공급자로 전환해 보세요
  • AI 설정을 기본값으로 재설정하세요

MCP 서버 문제

모델 컨텍스트 프로토콜 서버 관련 문제:

서버가 시작되지 않을 때

  • Node.js가 설치되어 있고 접근 가능한지 확인하세요
  • 서버 패키지가 설치되었는지 확인하세요: npm list -g
  • MCP 구성 파일 구문을 확인하세요
  • 특정 오류 메시지에 대한 서버 로그를 확인하세요
  • 터미널에서 서버 명령을 수동으로 실행해 보세요

권한 오류

  • Sidian이 구성된 디렉토리에 대한 읽기/쓰기 권한이 있는지 확인하세요
  • 프로젝트 폴더의 파일 시스템 권한을 확인하세요
  • 필요한 경우 Sidian을 관리자 권한으로 실행하세요 (Windows)
  • MCP 구성 파일이 읽기 가능한지 확인하세요

서버가 계속 충돌할 때

  • MCP 서버 패키지를 최신 버전으로 업데이트하세요
  • 충돌하는 Node.js 버전이 있는지 확인하세요
  • 구성에서 타임아웃 값을 늘리세요
  • 시스템 리소스(CPU, 메모리)를 모니터링하세요
  • 오류 패턴에 대한 서버 로그를 확인하세요

성능 문제

느린 시작

  • 불필요한 확장 프로그램을 비활성화하세요
  • 확장 프로그램 캐시를 지우세요
  • 열려 있는 파일 수를 줄이세요
  • 작업 공간에 큰 파일이 있는지 확인하세요
  • 최신 Sidian 버전으로 업데이트하세요

높은 메모리 사용량

  • 사용하지 않는 파일과 탭을 닫으세요
  • 메모리를 많이 사용하는 확장 프로그램을 비활성화하세요
  • 파일 감시 범위를 줄이세요
  • 검색 및 심볼 캐시를 지우세요
  • 주기적으로 Sidian을 다시 시작하세요

높은 CPU 사용량

  • 과도하게 실행되는 확장 프로그램이 있는지 확인하세요
  • 실시간 기능을 일시적으로 비활성화하세요
  • AI 제안 빈도를 줄이세요
  • 리소스를 많이 사용하는 터미널을 닫으세요
  • 백그라운드 프로세스를 모니터링하세요

파일 및 편집기 문제

파일이 로드되지 않을 때

  • 파일 권한을 확인하세요
  • 파일 경로가 올바른지 확인하세요
  • 파일 탐색기를 새로고침해 보세요
  • 다른 프로세스에 의해 파일이 잠겨 있는지 확인하세요
  • 파일이 손상된 것처럼 보이면 Sidian을 다시 시작하세요

자동 저장이 작동하지 않을 때

  • 환경 설정에서 자동 저장 설정을 확인하세요
  • 쓰기 파일 권한을 확인하세요
  • 충분한 디스크 공간이 있는지 확인하세요
  • 파일이 읽기 전용인지 확인하세요
  • 쓰기 권한을 테스트하기 위해 수동 저장을 시도해 보세요

검색에서 파일을 찾지 못할 때

  • 검색 제외 패턴을 확인하세요
  • 파일 확장자가 필터링되지 않았는지 확인하세요
  • 검색 인덱스를 다시 빌드해 보세요
  • 파일이 .gitignore에 있는지 확인하세요
  • 검색 캐시를 지우고 다시 시작하세요

확장 프로그램 문제

확장 프로그램이 설치되지 않을 때

  • 인터넷 연결을 확인하세요
  • 확장 프로그램 호환성을 확인하세요
  • 확장 프로그램 캐시를 지우세요
  • VSIX 파일에서 설치를 시도해 보세요
  • 사용 가능한 디스크 공간을 확인하세요

확장 프로그램 오류

  • 출력 패널에서 확장 프로그램 로그를 확인하세요
  • 충돌하는 확장 프로그램을 비활성화하세요
  • 확장 프로그램을 최신 버전으로 업데이트하세요
  • 확장 프로그램 설정을 재설정하세요
  • 확장 프로그램 제작자에게 문제를 보고하세요

확장 프로그램이 로드되지 않을 때

  • 확장 프로그램이 활성화되어 있는지 확인하세요
  • 확장 프로그램 종속성을 확인하세요
  • 창을 다시 로드해 보세요 (Ctrl+Shift+P → Reload Window)
  • 확장 프로그램 업데이트를 확인하세요
  • 확장 프로그램을 다시 설치하세요

Git 통합 문제

Git 명령이 실패할 때

  • Git이 설치되어 있고 PATH에 있는지 확인하세요
  • 리포지토리 상태를 확인하세요
  • 적절한 Git 구성인지 확인하세요
  • 터미널에서 Git 작업을 시도해 보세요
  • 파일 권한을 확인하세요

병합 충돌

  • 내장된 병합 충돌 해결사를 사용하세요
  • 충돌하는 변경 사항이 있는지 확인하세요
  • 모든 변경 사항이 스테이징되었는지 확인하세요
  • 수동 충돌 해결을 시도해 보세요
  • 필요한 경우 외부 병합 도구를 사용하세요

Push/Pull 문제

  • 원격 리포지토리 접근 권한을 확인하세요
  • 인증 자격 증명을 확인하세요
  • 네트워크 연결을 확인하세요
  • 터미널에서 Git 작업을 시도해 보세요
  • Git을 최신 버전으로 업데이트하세요

터미널 문제

터미널이 열리지 않을 때

  • 기본 셸 구성을 확인하세요
  • 셸 실행 파일이 존재하는지 확인하세요
  • 다른 셸(bash, zsh, PowerShell)을 시도해 보세요
  • 터미널 설정을 확인하세요
  • 터미널 구성을 재설정하세요

명령을 찾을 수 없을 때

  • PATH 환경 변수를 확인하세요
  • 명령 설치를 확인하세요
  • 실행 파일의 전체 경로를 시도해 보세요
  • 셸 구성 파일을 확인하세요
  • 터미널 세션을 다시 시작하세요

터미널 표시 문제

  • 터미널 글꼴 설정을 확인하세요
  • 색상 구성표 구성을 확인하세요
  • 다른 터미널 렌더러를 시도해 보세요
  • 유니코드 지원을 확인하세요
  • 터미널 모양 설정을 재설정하세요

디버깅 문제

디버거가 시작되지 않을 때

  • 디버그 구성을 확인하세요
  • 디버거 설치를 확인하세요
  • launch.json 구문을 확인하세요
  • 다른 디버그 어댑터를 시도해 보세요
  • 포트 가용성을 확인하세요

중단점이 작동하지 않을 때

  • 소스 맵이 올바른지 확인하세요
  • 코드가 최적화되었는지 확인하세요
  • 시작 후 중단점 설정을 시도해 보세요
  • 디버거 연결을 확인하세요
  • 파일 경로가 일치하는지 확인하세요

변수가 표시되지 않을 때

  • 디버그 콘솔에서 오류를 확인하세요
  • 변수 스코프를 확인하세요
  • 다른 디버그 어댑터를 시도해 보세요
  • 표현식 구문을 확인하세요
  • 디버깅 세션을 다시 시작하세요

추가 도움 받기

문서

  • docs.sidian.dev의 공식 문서를 확인하세요
  • 확장 프로그램 문서를 확인하세요

커뮤니티 지원

  • Sidian Discord 서버에 참여하세요
  • Stack Overflow에서 검색하세요

직접 지원

  • support@sidian.dev로 연락하세요
  • 오류 로그와 스크린샷을 포함하세요
  • 재현 단계를 설명하세요
  • 시스템 구성을 언급하세요

진단 정보

문제를 보고할 때 다음을 포함하세요:

  • Sidian 버전
  • 운영 체제
  • 오류 메시지
  • 재현 단계
  • 확장 프로그램 목록
  • 시스템 사양

대부분의 문제는 이러한 문제 해결 단계를 따르면 해결될 수 있습니다. 문제가 지속되면 주저하지 말고 커뮤니티나 지원팀에 문의하세요.