skymaxi4

개발환경 구축 삽질기: VSCode, Git, Docker, WSL 완벽 세팅

최근 Windows 미니 PC에 Ubuntu WSL2를 설치하고 개발 환경을 구축하면서 예상치 못한 문제들을 겪었습니다. 특히 Docker와 VSCode 연동 과정에서 삽질했던 경험을 바탕으로, 2026년 최신 정보를 반영한 완벽 세팅 가이드를 공유합니다.

1. WSL2 설치 및 Ubuntu 설정

WSL(Windows Subsystem for Linux)은 Windows에서 Linux 환경을 사용할 수 있게 해주는 강력한 도구입니다. WSL2는 가상화 기술을 통해 Linux 커널을 실행하여 WSL1보다 훨씬 빠른 성능을 제공합니다. 먼저 WSL2를 설치하고 Ubuntu를 설정하는 방법은 다음과 같습니다.

개발환경 구축: VSCode, Git, Docker 완벽 세팅 가이드 관련 이미지 1
  1. WSL 활성화: 관리자 권한으로 PowerShell을 실행하고 다음 명령어를 입력합니다. 
    dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
  2. 가상 머신 플랫폼 활성화: PowerShell에서 다음 명령어를 실행합니다. 
    dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  3. WSL2 커널 업데이트: Microsoft 공식 문서에서 최신 WSL2 Linux 커널 업데이트 패키지를 다운로드하여 설치합니다.
  4. WSL2 기본 버전 설정: PowerShell에서 다음 명령어를 실행하여 WSL2를 기본 버전으로 설정합니다. 
    wsl --set-default-version 2
  5. Ubuntu 설치: Microsoft Store에서 Ubuntu를 검색하여 설치합니다.

WSL2 설치 후 Ubuntu를 처음 실행하면 사용자 이름과 비밀번호를 설정해야 합니다. 이후 Ubuntu 환경에서 개발에 필요한 패키지를 설치하고 설정을 진행할 수 있습니다.

2. VSCode와 WSL2 연동

VSCode는 강력한 기능과 다양한 확장 기능으로 많은 개발자들에게 사랑받는 에디터입니다. VSCode Remote-WSL 확장을 사용하면 VSCode에서 WSL2 환경에 직접 접속하여 개발할 수 있습니다. 로컬 환경과 동일한 개발 경험을 제공하며, 경로 지정 문제나 OS 간 호환성 문제를 해결할 수 있습니다.

  1. Remote-WSL 확장 설치: VSCode에서 Remote-WSL 확장을 검색하여 설치합니다.
  2. WSL 창에서 VSCode 실행: Ubuntu WSL2 터미널에서 code . 명령어를 실행하여 VSCode를 실행합니다.
  3. Remote-WSL 연결 확인: VSCode 하단 상태 표시줄에 “WSL: Ubuntu”와 같이 WSL2에 연결되었음을 나타내는 문구가 표시되는지 확인합니다.

VSCode Remote-WSL 확장을 사용하면 WSL2 파일 시스템에 저장된 프로젝트를 열고 편집할 수 있습니다. 터미널, 디버거 등 VSCode의 모든 기능을 WSL2 환경에서 사용할 수 있습니다.

3. Git 설치 및 설정

Git은 분산 버전 관리 시스템으로, 코드 변경 사항을 추적하고 협업을 용이하게 해줍니다. Git을 설치하고 설정하는 것은 개발 환경 구축의 기본입니다. Ubuntu WSL2 환경에서 Git을 설치하고 사용자 정보를 설정하는 방법은 다음과 같습니다.

  1. Git 설치: Ubuntu 터미널에서 다음 명령어를 실행하여 Git을 설치합니다. 
    sudo apt update
sudo apt install git
  2. 사용자 정보 설정: Git을 사용하기 전에 사용자 이름과 이메일 주소를 설정해야 합니다. 다음 명령어를 실행하여 사용자 정보를 설정합니다. 
    git config --global user.name "Your Name"
git config --global user.email "[email protected]"

Git 설치 및 설정 후에는 GitHub, GitLab 등 원격 저장소와 연동하여 코드를 관리할 수 있습니다.

4. Docker 설치 및 VSCode 연동

Docker는 컨테이너 기반의 가상화 플랫폼으로, 애플리케이션을 격리된 환경에서 실행할 수 있게 해줍니다. Docker를 사용하면 개발, 테스트, 배포 환경을 일관성 있게 유지할 수 있으며, 다양한 종속성 문제를 해결할 수 있습니다. WSL2 환경에서 Docker를 설치하고 VSCode와 연동하는 방법은 다음과 같습니다.

개발환경 구축: VSCode, Git, Docker 완벽 세팅 가이드 관련 이미지 2
  1. Docker Desktop 설치: Docker 공식 웹사이트에서 Docker Desktop for Windows를 다운로드하여 설치합니다. 설치 시 WSL2 통합 옵션을 선택합니다.
  2. WSL 통합 활성화: Docker Desktop 설정에서 Resources -> WSL Integration 메뉴로 이동하여 Ubuntu를 포함한 WSL2 배포를 활성화합니다.
  3. VSCode Dev Containers 확장 설치: VSCode에서 Dev Containers 확장을 검색하여 설치합니다.

Docker Desktop 설치 후 VSCode Dev Containers 확장을 사용하면 Docker 컨테이너 안에서 개발 환경을 구축하고 사용할 수 있습니다. 이는 팀 단위 협업 시 동일한 개발 환경을 쉽게 공유할 수 있도록 해줍니다.

5. Docker를 활용한 개발 환경 구축

Docker 이미지를 활용하면 개발 환경을 쉽고 빠르게 구축할 수 있습니다. GitHub 또는 NVIDIA에서 제공하는 최신 Docker 이미지를 기반으로 개발 환경을 구축할 수 있으며, 이러한 이미지는 특정 프레임워크에 최적화되어 있어 설정 시간을 절약할 수 있습니다. 예를 들어, Python 개발 환경을 구축하기 위해 공식 Python Docker 이미지를 사용할 수 있습니다.

FROM python:3.9

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

CMD ["python", "app.py"]

위 Dockerfile은 Python 3.9 이미지를 기반으로 하고, requirements.txt 파일에 정의된 패키지를 설치한 후, 애플리케이션 코드를 컨테이너에 복사하고 실행합니다. 이처럼 Docker 이미지를 사용하면 개발 환경을 쉽게 구성하고 관리할 수 있습니다.

6. GitHub Copilot 연동 및 활용 (2026년 3월 업데이트)

2024년 12월 18일부터 GitHub Copilot이 Visual Studio Code에 기본 탑재되었습니다. 2026년 3월 현재, GitHub Copilot은 더욱 강력해진 AI 에이전트 기능을 제공하며, 개발 생산성을 향상시키는 데 큰 도움을 줍니다. GitHub 계정으로 로그인 시 무료로 사용 가능하며, GitHub 요금제나 Copilot 요금제로 이미 코파일럿을 사용 중일 경우 계정을 연동하여 사용할 수 있습니다.

최신 VSCode (1.111 버전)에서는 다음과 같은 GitHub Copilot 관련 기능이 강화되었습니다.

  • AI 에이전트 권한 조정: 에이전트가 수행할 수 있는 작업 범위를 세밀하게 조정할 수 있습니다.
  • 자율 반복 (Autopilot) 기능 (미리보기): Copilot이 코드를 자동으로 완성하고 반복적인 작업을 수행할 수 있습니다.
  • 에이전트 스코프 훅 (미리보기): 특정 코드 영역에 대해 Copilot의 동작을 제어할 수 있습니다.
  • 문제 해결 기능: Copilot이 코드 오류를 자동으로 감지하고 해결 방안을 제시합니다.

7. WSL vs Windows Docker 성능 비교

WSL에서 Docker 컨테이너를 실행하는 것과 Windows에서 Docker 컨테이너를 실행하는 것은 성능, 편의성 면에서 차이가 있습니다. 다음은 두 가지 방법의 장단점을 비교한 표입니다.

개발환경 구축: VSCode, Git, Docker 완벽 세팅 가이드 관련 이미지 3
구분 WSL에서 실행 Windows에서 실행
비용 WSL 자체는 무료. Docker Desktop은 개인 및 소규모 비즈니스용 무료. Docker Desktop은 개인 및 소규모 비즈니스용 무료.
성능 일반적으로 Windows보다 성능이 좋습니다. 특히 I/O가 많은 작업에서 유리합니다. WSL에 비해 성능이 떨어질 수 있습니다.
편의성 리눅스 환경과 동일하므로, 리눅스 서버 배포 시 유리합니다. 윈도우 환경에 익숙한 사용자에게는 더 편리할 수 있습니다.

개인적인 경험으로는 WSL2에서 Docker를 실행하는 것이 I/O 성능 면에서 훨씬 유리했습니다. 특히 대규모 프로젝트를 빌드하거나 데이터베이스 작업을 수행할 때 WSL2 환경에서 훨씬 빠른 속도를 체감할 수 있었습니다.

8. 문제 해결 및 트러블슈팅

개발 환경을 구축하는 과정에서 다양한 문제에 직면할 수 있습니다. 다음은 흔히 발생하는 문제와 해결 방법입니다.

  • Docker Desktop WSL 통합 문제: Docker Desktop 설정에서 WSL 통합이 활성화되어 있는지 확인하고, WSL2 배포가 Docker Desktop에 의해 감지되는지 확인합니다.
  • VSCode Remote-WSL 연결 문제: VSCode가 WSL2에 제대로 연결되지 않는 경우, VSCode를 다시 시작하거나 Remote-WSL 확장을 다시 설치해 봅니다.
  • Git 인증 문제: GitHub 또는 GitLab에 push할 때 인증 오류가 발생하는 경우, SSH 키를 설정하거나 Git 자격 증명 관리자를 사용하여 인증 정보를 저장합니다.

이 외에도 다양한 문제가 발생할 수 있으며, 각 문제에 대한 해결 방법은 Stack Overflow와 같은 커뮤니티에서 찾을 수 있습니다.

9. Git 최신 버전 정보 (2026년 2월)

2026년 2월 2일, Git 최신 소스 릴리스 버전은 2.53.0입니다. 최신 버전의 Git은 다양한 버그 수정과 성능 개선을 포함하고 있으므로, 가능하면 최신 버전을 사용하는 것이 좋습니다. Git을 업데이트하려면 다음 명령어를 실행합니다.

sudo apt update
sudo apt upgrade git

Git 최신 버전 정보는 Git 공식 웹사이트에서 확인할 수 있습니다.

결론: 완벽한 개발 환경 구축으로 생산성 향상

VSCode, Git, Docker, WSL을 활용한 개발 환경 구축은 초기 설정에 시간이 소요될 수 있지만, 장기적으로 개발 생산성을 크게 향상시킬 수 있습니다. 특히 Docker를 사용하면 개발 환경을 일관성 있게 유지하고 배포 과정을 간소화할 수 있으며, GitHub Copilot과 같은 AI 도구를 활용하면 코딩 속도를 더욱 높일 수 있습니다. 지금 바로 WSL2를 설정하고, VSCode와 Docker를 연동하여 생산적인 개발 환경을 구축해 보세요.

함께 읽으면 좋은 글

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다