최종 업데이트: · 대상: VS Code 초급~중급 개발자
핵심 요약
VS Code에서 자동완성, 함수 시그니처, 정의 이동이 작동하지 않는 문제는 대부분 언어 모드 설정, 언어 서버 오류, 확장 프로그램 충돌, 워크스페이스 신뢰 문제 중 하나입니다. 아래 방법을 순서대로 따르면 5분 내에 해결할 수 있습니다.
즉시 해결 방법 (3분)
⚠️ 먼저 이것부터!
- 화면 하단 상태표시줄에서 언어 모드 확인 (.ts → TypeScript, .py → Python)
- (Windows/Linux: Ctrl+Shift+P, macOS: ⌘+Shift+P) → Developer: Reload Window 실행
- 언어별 서버 재시작:
- TypeScript/JavaScript: TypeScript: Restart TS Server
- Python: Restart Language Server
- C/C++: C/C++: Reset IntelliSense Database
VS Code Command Palette에서 'Developer: Reload Window'를 입력한 모습
문제 증상 확인
- 자동완성 목록이 나타나지 않거나 기본 단어만 표시됨
- 함수 매개변수 힌트가 보이지 않음
- F12 (정의로 이동)가 동작하지 않음
- 상태표시줄에 Plain Text로 표시됨
- 폴더를 열 때 상단에 제한 모드(Restricted Mode) 알림이 나타남
상세 해결 방법
1️⃣ 언어 모드 올바른 설정 확인
상태표시줄 우측 하단의 언어명을 클릭하여 파일 확장자에 맞는 언어로 변경하세요.
2️⃣ 필수 확장 프로그램 상태 점검
언어별로 필요한 확장 프로그램들이 활성화 상태인지 확인하세요:
- JavaScript/TypeScript: TypeScript and JavaScript Language Features (내장 확장)
- Python: Python + Pylance
- C/C++: C/C++ (ms-vscode.cpptools)
3️⃣ VS Code 창 및 언어 서버 새로고침
- (Windows/Linux: Ctrl+Shift+P, macOS: ⌘+Shift+P) → Developer: Reload Window
- 같은 방법으로 언어별 서버 재시작:
- TypeScript: Restart TS Server
- Restart Language Server
4️⃣ 워크스페이스 신뢰 설정
처음 열 때 노란색 알림이 나타나면 Trust 버튼을 클릭하세요.
5️⃣ 프로젝트 설정 파일 검증
- TS/JS: tsconfig.json 또는 jsconfig.json 확인, include 경로 점검
- Python: Python: Select Interpreter 실행 → 가상환경 확인
- C/C++: C/C++: Edit Configurations (UI)에서 includePath 점검
6️⃣ 확장 프로그램 충돌 진단
- 명령 팔레트: Extensions: Disable All Installed Extensions 실행
- 터미널:
code --disable-extensions - 문제 없으면 Help: Troubleshoot Issue → Extension Bisect 실행
7️⃣ 사용자 설정 초기화
Preferences: Open User Settings (JSON) 열고, 의심 설정을 제거해보세요.
✅ 최종 점검 사항
- 언어 모드가 파일 확장자와 일치
- 필수 확장 프로그램 활성화
- 창/언어 서버 재시작 완료
- 워크스페이스 신뢰됨
- 설정 파일 올바름
- 확장 충돌 점검 완료
자주 묻는 질문
자동완성이 전혀 나타나지 않고 Plain Text로 표시됩니다.
상태표시줄의 언어 모드를 파일 확장자에 맞게 변경하세요.
Git 브랜치 전환 후 TypeScript/ESLint가 작동하지 않습니다.
TypeScript: Restart TS Server와 Reload Window 실행으로 해결되는 경우가 많습니다.
Python만 IntelliSense가 작동하지 않습니다.
명령 팔레트에서 Python: Select Interpreter 실행 → 가상환경 선택 확인.
모든 방법을 시도해도 해결되지 않습니다.
VS Code를 종료 후 재시작하거나 사용자 데이터 디렉토리를 임시 이동. (⚠️ 고급 사용자 전용)
0 댓글