윈도우11 wsl2 ubuntu24 vscode 연결

윈도우11에 wsl2를 설치하고 ubuntu24를 설치했음.  이클클리스 경로는 "/home/linux/egovframedev5/workspace-egov"임. vscode 터미널로 연결해서 사용하고 싶음. 어떻게 연결해야 하나?

WSL2에 설치한 Ubuntu 24.04 환경과 그 안의 특정 프로젝트 경로를 Windows의 VS Code와 연결하고 싶으시군요! 대단히 훌륭한 개발 환경 구성입니다.

VS Code는 WSL을 공식적으로 완벽하게 지원하기 때문에 아주 간단하게 연동할 수 있습니다. 아래 단계를 차근차근 따라 해보세요.

1단계: VS Code 필수 확장 팩 설치 (Windows에서 수행)

우선 Windows에 설치된 VS Code를 열고, WSL 내부 파일에 접근할 수 있도록 플러그인을 설치해야 합니다.

1.    VS Code를 실행합니다.

2.    왼쪽 사이드바에서 확장(Extensions) 아이콘(블록 모양, 단축키 Ctrl + Shift + X)을 클릭합니다.

3.    검색창에 WSL을 검색합니다.

4.    Microsoft에서 만든 WSL (구 이름: Remote - WSL) 확장 프로그램을 찾아 Install(설치)을 누릅니다.

2단계: VS Code 터미널로 Ubuntu 연결 및 경로 이동

가장 직관적이고 빠른 방법은 Ubuntu 터미널에서 명령어를 통해 VS Code를 바로 호출하는 것입니다.

1.    Windows에서 Ubuntu 24.04 앱(또는 Windows 터미널)을 실행합니다.

2.    원하는 이클립스 작업 공간 경로로 이동합니다. 아래 명령어를 입력하세요.

Bash

cd /home/linux/egovframedev5/workspace-egov

3.    해당 경로에서 VS Code를 실행하는 명령어를 입력합니다. (.은 현재 디렉토리를 의미합니다)

Bash

code .

💡 처음 실행할 때 참고: code .을 처음 입력하면 WSL 내부적으로 VS Code Server를 다운로드하고 설치하는 과정이 잠시 진행됩니다. 조금만 기다리면 Windows 화면에 새로운 VS Code 창이 자동으로 열립니다.

3단계: 연결 확인 및 VS Code 내장 터미널 사용

이제 VS Code 창이 열렸을 텐데, 제대로 연결되었는지 확인하고 내장 터미널을 열 차례입니다.

• 연결 확인: VS Code 왼쪽 아래 구석을 보시면 파란색(또는 초록색) 배경에 WSL: Ubuntu-24.04라고 표시되어 있다면 성공적으로 연동된 것입니다.
• 터미널 열기: 1. 상단 메뉴에서 Terminal -> New Terminal을 클릭합니다 (단축키: Ctrl + ` ). 2. 하단에 열리는 터미널이 Windows의 PowerShell이 아닌 Ubuntu(Bash) 터미널로 열려 있고, 경로가 /home/linux/egovframedev5/workspace-egov로 잡혀 있는지 확인합니다.

💡 꿀팁: 다음부터 더 쉽게 여는 방법 (VS Code에서 바로 열기)

매번 Ubuntu 터미널을 켜서 code .을 치기 귀찮으시다면, VS Code 안에서 바로 접속할 수도 있습니다.

1.    Windows에서 VS Code를 그냥 켭니다.

2.    왼쪽 아래 원격 연결 아이콘(>< 모양)을 클릭하거나 단축키 Ctrl + Shift + P를 눌러 명령 팔레트를 엽니다.

3.    Connect to WSL (또는 WSL: Connect to WSL using Distro...에서 Ubuntu-24.04 선택)을 클릭합니다.

4.    WSL 환경으로 연결되면 File -> Open Folder를 누른 뒤, 열리는 경로창에 /home/linux/egovframedev5/workspace-egov를 입력하고 확인을 누르면 됩니다.

"root@DESKTOP-GK0BRBG:/home/linux/egovframedev5# code .

Command 'code' not found, but can be installed with:

snap install code" 해결 방법?

현재 WSL2 환경(Ubuntu)에서 Windows에 설치된 VS Code를 실행하는 code 명령어를 찾지 못해서 발생하는 문제입니다. 보통 WSL을 먼저 설치한 뒤에 Windows용 VS Code를 설치했거나, VS Code 설치 시 환경 변수(Path) 옵션을 체크하지 않았을 때 발생합니다.

이 문제를 해결하는 가장 확실한 3가지 방법을 안내해 드릴 테니, 순서대로 시도해 보세요! (⚠️ 오류 메시지에 나오는 snap install code는 절대 실행하시면 안 됩니다! 그것은 리눅스용 VS Code를 WSL 안에 설치하는 것이라 엉뚱하게 꼬일 수 있습니다.)

방법 1: Windows 환경 변수(Path) 자동 등록하기 (가장 추천)

Windows에 설치된 VS Code가 WSL에 자신이 어디 있는지 알려주지 못하고 있는 상태입니다. VS Code를 다시 열어 설정을 업데이트해 주면 해결됩니다.

1.    Windows에서 VS Code를 실행합니다.

2.    Ctrl + Shift + P를 눌러 명령 팔레트를 엽니다.

3.    검색창에 Shell Command를 입력합니다.

4.    만약 Shell Command: Install 'code' command in PATH라는 항목이 보인다면 클릭하여 설치합니다.

o   참고: 최근 버전에서는 이 과정이 자동으로 처리되기도 하므로, 만약 이 메뉴가 보이지 않는다면 다음 단계를 진행하세요.

5.    열려 있는 WSL(Ubuntu) 터미널 창을 완전히 닫았다가 다시 실행합니다. (환경 변수 적용을 위해 필수)

6.    다시 프로젝트 경로로 이동하여 code .을 입력해 봅니다.

방법 2: Windows의 VS Code 경로를 직접 연결하기 (수동 해결)

만약 방법 1로 해결되지 않는다면, WSL 내부에서 Windows용 VS Code의 실행 파일 위치를 강제로 알려주는 방법입니다.

1.    WSL 터미널에 아래 명령어를 그대로 복사해서 붙여넣고 엔터를 누릅니다. (Windows에 기본 경로로 설치된 VS Code의 실행 파일을 직접 실행하는 명령입니다.)

Bash

/mnt/c/Users/$USER/AppData/Local/Programs/Microsoft\ VS\ Code/bin/code .

o   만약 위 명령어로 VS Code가 잘 열린다면, 앞으로 편하게 code만 입력해도 작동하도록 별칭(Alias)을 등록해 주면 됩니다.

2.    아래 명령어를 한 줄씩 차례대로 실행하여 별칭을 등록합니다.

Bash

echo "alias code='/mnt/c/Users/\$USER/AppData/Local/Programs/Microsoft\ VS\ Code/bin/code'" >> ~/.bashrc

source ~/.bashrc

3.    이제 다시 code .을 입력해 봅니다.

방법 3: VS Code에서 '반대로' WSL 폴더 열기 (터미널 명령어 생략)

터미널에서 code . 명령어가 계속 안 먹힌다면, 굳이 터미널을 고집하지 않고 Windows VS Code 창에서 WSL 폴더를 직접 불러오는 방식을 사용하면 됩니다. 똑같이 연결됩니다!

1.    Windows에서 VS Code를 켭니다.

2.    왼쪽 아래의 파란색/초록색 원격 연결 아이콘(>< 모양)을 클릭합니다.

3.    상단에 열리는 메뉴에서 Connect to WSL을 선택합니다.

4.    WSL에 연결되면 VS Code 상단 메뉴에서 File(파일) -> Open Folder(폴더 열기)를 클릭합니다.

5.    경로 입력창이 뜨면 아래와 같이 회원님의 프로젝트 경로를 그대로 입력하고 OK를 누릅니다.

/home/linux/egovframedev5/workspace-egov

이렇게 열면 터미널 창에서 code .을 친 것과 완벽하게 동일하게 작동하며, 내부 터미널(Ctrl + ~)도 자동으로 Ubuntu 24.04로 연동됩니다.