Bluelockr/WSL2로 VSCODE Python 개발 환경 구축하기

Created Tue, 25 Apr 2023 00:00:00 +0000 Modified Tue, 12 May 2026 03:50:56 -0700

⭐Visual Studio Code 설치

https://code.visualstudio.com/

위 링크에서 Visual Studio Code를 다운받아 설치합니다.

Alt text

이 때 주의할 점이 하나 있는데, ‘PATH에 추가’ 체크박스에 꼭 체크해주셔야 한다는 점입니다.
안 그러면 귀찮아집니다.

⭐Windows 기능 켜기/끄기

Alt text

제어판 -> 프로그램 -> 프로그램 및 기능 -> Windows 기능 켜기/끄기에 들어가 Linux용 Windows 하위 시스템가상 머신 플랫폼의 체크박스를 누르고 확인 버튼을 누릅니다.(재부팅 필요)

⭐최신 WSL2 Linux커널 업데이트 패키지 설치

https://learn.microsoft.com/ko-kr/windows/wsl/install-manual

위 링크에서 x64 머신용 최신 WSL2 Linux커널 업데이트 패키지를 다운로드 후 실행하여 설치합니다.

⭐Ubuntu 앱 설치 및 실행

Microsoft Store에서 ubuntu를 설치하고 실행합니다.

Alt text

계정명과 비밀번호는 자신이 원하는 대로 해줍니다.

⭐wsl 설정

Powershell을 관리자 권한으로 실행 후,

wsl -l -v

을 입력하고 엔터 키를 누릅니다.
VERSION이 1로 설정되어있으면 다음 명령어를 입력해 2로 변경합니다.

wsl --set-default-version 2

그리고 VSCODE에서 Extension 중에 WSL를 설치합니다.

https://learn.microsoft.com/ko-kr/power-pages/configure/vs-code-extension
🔼VSCODE Extension 설치법

⭐파이썬 설치

우분투 앱에서 다음 명령어를 실행하여 파이썬 관련 프로그램을 설치합니다.

sudo apt-get update
sudo apt-get install python3 python3-pip -y

python3 --version
pip --version

⭐소스 파일 빌드

💧프로그래밍 관련 폴더 생성

우분투 앱으로 돌아가서 다음 명령어를 입력하여 프로그래밍을 위한 폴더를 생성합니다.

mkdir Coding
cd Coding
code .

이제 VSCODE가 실행됩니다.

💧소스 파일 생성

이제 파이썬 소스 코드를 작성해봅니다.
저는 python.py 라는 소스 파일을 다음과 같은 내용으로 작성하고 저장하였습니다.

print('hello world')

💧VSCODE Python 확장 프로그램 설치

VSCODE에서 Extension 중에 Python을 설치합니다.

Alt text

이제 Python 실행 버튼을 눌러 작성한 코드를 실행할 수 있습니다.
만일 실행 버튼이 나타나지 않는다면 Extension 중에서 **Run++**를 설치하면 됩니다.

참고한 글 :
WSL & WSL2 설치와 VSCode 연동하기 (velog.io)