Visual Studio Code에서 code 명령어 (터미널에서 Visual Studio Code 실행 명령어)가 작동하지 않는 오류는 주로 PATH 환경 변수에 VS Code 설치 경로가 등록되지 않아서 발생합니다. 해결 방법은 VS Code 설치 경로를 PATH 환경 변수에 추가하는 것입니다.
명령어(python, npm, git 등)가 설치되어 있는지 확인
시스템 PATH 환경 변수에 등록되어 있는지 확인
시스템 PATH 환경 변수에 등록되어 있는지 확인
Visual Studio Code를 설치할 때, 터미널에서 code 명령어를 사용하여 프로젝트 폴더를 쉽게 열 수 있도록 PATH 환경 변수에 VS Code 실행 파일 경로를 추가해야 합니다. 하지만 설치 과정에서 이 부분이 자동으로 처리되지 않거나, 사용자가 수동으로 경로를 추가하지 않은 경우, code 명령어를 인식하지 못하는 오류가 발생합니다.
해결 방법
-
1. VS Code 설치 경로 확인:
- 일반적으로 VS Code 실행 파일은 다음 위치에 있습니다.
- Windows: C:\Users\<사용자 이름>\AppData\Local\Programs\Microsoft VS Code\Code.exe
- macOS: /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code
- 확인 후, 자신의 환경에 맞는 경로를 복사합니다.
- 일반적으로 VS Code 실행 파일은 다음 위치에 있습니다.
-
2. PATH 환경 변수 설정:
- Windows:
- 검색창에서 "환경 변수"를 검색하여 "시스템 환경 변수 편집"을 클릭합니다.
- "환경 변수" 버튼을 클릭합니다.
- "시스템 변수" 영역에서 "Path"를 선택하고 "편집" 버튼을 클릭합니다.
- "새로 만들기"를 클릭하고 VS Code 설치 경로를 붙여넣습니다.
- 확인을 클릭하여 변경 사항을 저장합니다.
- macOS:
- 터미널을 열고 nano ~/.zshrc 또는 nano ~/.bash_profile 명령어를 입력합니다.
- 파일 끝에 다음 줄을 추가합니다.
- export PATH="$PATH:/Applications/Visual Studio Code.app/Contents/Resources/app/bin"
- Ctrl + X를 누르고 Y를 누른 후 Enter 키를 눌러 저장합니다.
- source ~/.zshrc 또는 source ~/.bash_profile 명령어를 입력하여 변경 사항을 적용합니다.
- Windows:
-
3. 터미널 재시작:
- 변경된 PATH 환경 변수를 적용하려면 터미널을 닫았다가 다시 열어야 합니다.
- 변경된 PATH 환경 변수를 적용하려면 터미널을 닫았다가 다시 열어야 합니다.
추가 정보:
-
명령 팔레트 사용:VS Code 내에서 Ctrl + Shift + P (또는 Cmd + Shift + P macOS)를 눌러 명령 팔레트를 열고 "Shell Command: Install 'code' command in PATH"를 검색하여 설치할 수도 있습니다. 그러나 이 방법이 항상 제대로 작동하지 않을 수 있습니다.
-
권한 문제:경우에 따라 관리자 권한으로 VS Code를 실행해야 할 수도 있습니다. 만약 위 방법으로 해결되지 않으면, VS Code를 관리자 권한으로 실행해 보시기 바랍니다.