Visual Studio Code 오류 해결방법 팁

Visual Studio Code (VS Code)는 전 세계 개발자들이 가장 많이 사용하는 에디터 중 하나입니다.

가볍고 빠르며, 수많은 확장 프로그램을 통해 강력한 기능을 제공하기 때문이죠.

 

하지만 때로는 알 수 없는 오류나 버그 때문에 작업이 막히는 경우가 있습니다.

이번 글에서는 VS Code를 사용하면서 자주 발생하는 오류들을 정리하고,

초보자도 쉽게 따라 할 수 있는 해결 방법과 팁을 상세하게 알려드립니다.

더 이상 오류 때문에 시간을 낭비하지 마세요. 이 글을 통해 쾌적한 개발 환경을 만들어 보세요!

Visual Studio Code 오류 해결방법 팁

VS Code 오류 해결 핵심 요약

• 자주 발생하는 'Linter' 및 'Formatter' 오류 해결법
• '터미널'에서 Git 명령어가 작동하지 않을 때
• '확장 프로그램' 충돌 및 비활성화 방법
• VS Code 업데이트 후 발생하는 오류 대처법
• 알 수 없는 오류 발생 시 '개발자 도구' 활용 팁

1. 'Linter' 및 'Formatter' 오류 해결법

VS Code를 사용하면서 가장 흔하게 접하는 오류는 바로 코드 스타일을 검사하는 Linter나 코드를 자동으로 정리해 주는 Formatter 관련 오류입니다.

문제: Linter가 경고 메시지를 계속 표시해요.

해결 방법: 대부분의 경우, 프로젝트의 규칙과 VS Code의 설정이 일치하지 않아 발생하는 문제입니다. 프로젝트 루트 폴더에 '.eslintrc.js'나 '.prettierrc.js'와 같은 설정 파일이 있는지 확인하고, 해당 파일의 규칙에 맞게 코드를 수정하거나 VS Code 설정을 변경해야 합니다.

꿀팁: VS Code에서 Ctrl + Shift + P를 누르고 Format Document를 실행하면, 현재 문서가 자동으로 포맷팅됩니다. 포맷팅 후에도 오류가 발생한다면, 설정 파일의 문법이 잘못되었을 가능성이 높습니다.

2. '터미널'에서 Git 명령어가 작동하지 않을 때

VS Code의 통합 터미널에서 git 명령어가 작동하지 않는 경우가 있습니다. 이는 Git이 제대로 설치되지 않았거나, VS Code가 Git의 경로를 찾지 못했기 때문입니다.

문제: 'git' 명령어를 찾을 수 없다는 오류가 떠요.

해결 방법:
Git 설치 여부 확인: 먼저 컴퓨터에 Git이 설치되어 있는지 확인해야 합니다. 터미널에서 git --version을 입력하여 버전 정보가 나오는지 확인해 보세요.
경로 설정: Git이 설치되어 있는데도 오류가 발생한다면, VS Code의 설정 파일(settings.json)에서 Git의 실행 파일 경로를 직접 지정해 줘야 합니다. File > Preferences > Settings (Mac은 Code > Settings)로 이동하여 "git.path"를 검색하고, Git이 설치된 경로를 입력해 주세요.

예시: "git.path": "C:\\Program Files\\Git\\cmd\\git.exe" (Windows 기준)

 

깃허브 초보자가 자주 묻는 질문 TOP 5

3. '확장 프로그램' 충돌 및 비활성화 방법

VS Code의 가장 큰 장점인 확장 프로그램은 때로는 충돌을 일으켜 오류의 원인이 되기도 합니다.

문제: 특정 확장 프로그램을 설치한 후 VS Code가 느려지거나 오류가 발생해요.

해결 방법:
확장 프로그램 비활성화: 최근에 설치한 확장 프로그램을 하나씩 비활성화해 보세요. Extensions 탭(왼쪽 사이드바의 네모 아이콘)에서 각 확장 프로그램 옆에 있는 'Disable' 버튼을 클릭하면 됩니다. 비활성화 후 문제가 해결된다면, 해당 확장 프로그램이 오류의 원인일 가능성이 높습니다.
확장 프로그램 제거: 충돌이 반복되는 확장 프로그램은 완전히 제거하는 것이 좋습니다.
--disable-extensions로 실행: VS Code를 실행할 때 code --disable-extensions 명령어를 사용하면 모든 확장 프로그램을 비활성화한 상태로 실행됩니다. 이 상태에서 오류가 발생하지 않는다면, 확장 프로그램 문제임을 확실히 알 수 있습니다.

4. VS Code 업데이트 후 발생하는 오류 대처법

VS Code는 정기적으로 업데이트되면서 새로운 기능이 추가되거나 버그가 수정됩니다. 하지만 드물게 업데이트 이후 기존에 잘 사용하던 기능이 작동하지 않거나 새로운 오류가 발생할 수 있습니다.

문제: 업데이트 후 갑자기 VS Code가 이상하게 작동해요.

해결 방법:
캐시 삭제: VS Code의 캐시 파일이 꼬여서 발생하는 경우가 있습니다. VS Code를 완전히 종료한 후, 사용자 폴더 아래에 있는 VS Code 관련 폴더를 삭제하고 재실행해 보세요. (단, 이 경우 기존 설정이 초기화될 수 있으므로 주의해야 합니다.)
이슈 확인: VS Code의 공식 깃허브 페이지에서 해당 오류에 대한 이슈가 있는지 확인해 보세요. 이미 많은 개발자들이 겪고 있는 문제라면 해결 방법이 나와 있을 가능성이 높습니다.
버전 다운그레이드: 임시 방편이지만, 문제가 해결될 때까지 이전 버전으로 다운그레이드하는 것도 한 가지 방법입니다.

 

 VS Code 확장기능 추천 리스트 최신 정리

VS Code 확장기능 추천 리스트 최신 정리

5. 알 수 없는 오류 발생 시 '개발자 도구' 활용 팁

위의 방법으로도 해결되지 않는 알 수 없는 오류가 발생한다면, VS Code 내장 '개발자 도구'를 활용해야 합니다.

사용법: Help > Toggle Developer Tools 메뉴를 선택하면, 웹 브라우저의 개발자 도구와 유사한 창이 나타납니다.

이 창의 Console 탭에서는 VS Code 내부에서 발생하는 오류 메시지를 확인할 수 있습니다.

오류 메시지를 복사하여 구글에 검색하면, 비슷한 문제를 겪은 다른 개발자들의 해결책을 찾을 수 있습니다.