윈도우11 WSL2 개발환경 세팅: 명령어 한 줄로 끝내는 세상에서 가장 쉬운 방법

윈도우11 WSL2 개발환경 세팅: 명령어 한 줄로 끝내는 세상에서 가장 쉬운 방법

 

윈도우 환경에서 개발을 시작하려는 분들에게 리눅스 환경은 필수적입니다. 과거에는 가상머신을 설치하거나 듀얼 부팅을 설정하는 번거로운 과정이 필요했지만, 이제는 WSL2(Windows Subsystem for Linux 2)를 통해 윈도우 내에서 완벽한 리눅스 환경을 구축할 수 있습니다. 이 글에서는 가장 빠르고 효율적으로 WSL2 개발환경을 세팅하는 방법을 단계별로 안내합니다.

목차

1. WSL2란 무엇인가
2. 사전 준비 사항 체크
3. WSL2 설치 단계 (가장 쉬운 방법)
4. 배포판(Ubuntu) 설정 및 사용자 생성
5. 개발 생산성을 높이는 필수 도구 설치
6. VS Code 연동 및 환경 최적화
7. 자주 발생하는 오류 및 해결책

WSL2란 무엇인가

• 정의: 윈도우 11 내에서 리눅스 커널을 직접 실행할 수 있게 해주는 하위 시스템입니다.
• 특징: 이전 버전(WSL1)보다 시스템 호출 호환성이 뛰어나며 파일 시스템 성능이 월등히 향상되었습니다.
• 장점: 도커(Docker), 파이썬(Python), 노드(Node.js) 등 다양한 개발 도구를 리눅스 환경에서 네이티브 수준의 성능으로 구동할 수 있습니다.

사전 준비 사항 체크

• OS 버전 확인: 윈도우 11은 기본적으로 모든 버전을 지원합니다.
• 가상화 활성화: 메인보드 BIOS 설정에서 Virtualization Technology(Vanderpool 또는 SVM)가 Enabled 상태여야 합니다.
• 인터넷 연결: 리눅스 커널 및 배포판 설치 파일을 다운로드하기 위해 안정적인 네트워크가 필요합니다.

WSL2 설치 단계 (가장 쉬운 방법)

과거에는 여러 기능을 수동으로 켜야 했지만, 현재 윈도우 11에서는 단 한 줄의 명령어로 모든 과정이 자동화됩니다.

• 터미널 실행: '시작' 버튼 우클릭 후 '터미널(관리자)' 또는 'PowerShell(관리자)'을 선택합니다.
• 설치 명령어 입력: 다음 명령어를 입력하고 엔터를 누릅니다.
• wsl --install

• 자동 프로세스: 이 명령어는 가상 머신 플랫폼 활성화, WSL 기능 활성화, 최신 리눅스 커널 다운로드, 기본 배포판(Ubuntu) 설치를 한 번에 진행합니다.
• 시스템 재부팅: 설치가 완료되었다는 메시지가 뜨면 반드시 윈도우를 다시 시작해야 설정이 적용됩니다.

배포판(Ubuntu) 설정 및 사용자 생성

재부팅 후 자동으로 리눅스 터미널 창이 나타납니다. 만약 나타나지 않는다면 시작 메뉴에서 'Ubuntu'를 찾아 실행합니다.

• 초기화 대기: 'Installing, this may take a few minutes...' 메시지가 나오며 초기 설정을 진행합니다.
• 사용자 이름 설정: 리눅스에서 사용할 ID를 입력합니다 (윈도우 ID와 달라도 무관합니다).
• 비밀번호 설정: 사용할 비밀번호를 두 번 입력합니다. 입력 시 화면에 글자가 보이지 않는 것은 보안상의 정상적인 현상입니다.
• 패키지 업데이트: 설치 직후 최신 상태를 유지하기 위해 다음 명령어를 실행합니다.
• sudo apt update && sudo apt upgrade -y

개발 생산성을 높이는 필수 도구 설치

리눅스 환경이 준비되었다면 개발에 필요한 기본 소프트웨어를 설치해야 합니다.

• Git 설치: 버전 관리를 위해 필수적입니다.
• sudo apt install git -y

• Build Essential: C/C++ 컴파일러 등 기본 개발 도구 모음입니다.
• sudo apt install build-essential -y

• 명령어 별칭(Alias) 설정: .bashrc 파일을 수정하여 자주 쓰는 명령어를 단축어로 등록하면 편리합니다.
• Zsh 및 Oh My Zsh: 기본 터미널보다 가독성이 좋은 셸 환경을 구축할 수 있습니다.

VS Code 연동 및 환경 최적화

WSL2의 진가는 비주얼 스튜디오 코드(VS Code)와 결합될 때 나타납니다.

• WSL 확장 설치: 윈도우용 VS Code를 실행한 뒤 확장(Extensions) 마켓플레이스에서 'WSL'을 검색하여 설치합니다.
• 터미널에서 코드 실행: Ubuntu 터미널에서 프로젝트 폴더로 이동한 후 code .을 입력합니다.
• 원격 접속 확인: VS Code 왼쪽 하단에 'WSL: Ubuntu'라는 파란색 표시가 뜨면 리눅스 환경에서 직접 코딩하는 상태가 된 것입니다.
• 윈도우 터미널 활용: 기본 CMD 대신 MS 스토어에서 'Windows Terminal'을 설치하여 사용하면 다중 탭과 테마 기능을 활용할 수 있습니다.

자주 발생하는 오류 및 해결책

세팅 과정에서 막힐 경우 다음 사항을 점검하십시오.

• 0x80370102 오류: 하드웨어 가상화가 꺼져 있을 때 발생합니다. BIOS 설정에서 가상화 옵션을 켜야 합니다.
• 커널 업데이트 요구: wsl --update 명령어를 실행하여 수동으로 커널을 최신화합니다.
• 네트워크 연결 문제: VPN이 켜져 있거나 방화벽 설정이 엄격할 경우 리눅스 내에서 인터넷이 안 될 수 있습니다. 이 경우 /etc/resolv.conf 파일의 네임서버를 8.8.8.8로 변경해 봅니다.
• WSL 버전 확인: wsl -l -v 명령어를 통해 설치된 리눅스가 버전 2로 동작하고 있는지 확인합니다. 만약 버전 1이라면 wsl --set-version Ubuntu 2 명령어로 변경 가능합니다.

이 가이드를 따라 하시면 10분 이내에 윈도우 11 환경에서 강력한 리눅스 개발 서버를 구축할 수 있습니다. 이제 윈도우의 편리함과 리눅스의 강력한 개발 도구들을 동시에 누려보시기 바랍니다.

 

더 자세한 내용은 아래를 참고하세요.

 

더 자세한 자료 보기