본문 바로가기
IT

리눅스에서 VS Code 개발 환경 세팅하는 법 — Git·Python·Node.js 연동까지

by Mindy.s 2026. 3. 30.

Xubuntu를 설치하고 나면 개발 환경은 직접 세팅해야 합니다.

윈도우나 맥에서 넘어온 분이라면 "어디서부터 시작해야 하지?" 싶은 게 당연해요. 저도 처음엔 막막했습니다. 리눅스 터미널이 어느 정도 익숙해지고 나서야 개발 환경 세팅이 생각보다 훨씬 간단하다는 걸 알았어요.

VS Code 설치부터 Git, Python, Node.js까지 — 실제로 코딩을 시작할 수 있는 환경을 만드는 과정을 순서대로 정리했습니다. 크롬북(HP Chromebook 13 G1, Core M, 8GB)에서 직접 세팅한 경험을 바탕으로 썼어요.

📦 VS Code 설치

리눅스에서 VS Code를 설치하는 방법은 두 가지입니다. 아래 이유로 .deb 파일 방식을 추천해요.

방법 2 — snap 설치 대안
sudo snap install code --classic

snap 버전은 한글 입력이 안 되는 경우가 있어서 .deb 방식을 더 추천합니다.

⌨️ VS Code 한글 입력 문제 해결

VS Code에서 한글 입력이 안 되는 건 리눅스에서 꽤 흔한 문제예요. fcitx5를 쓰고 있다면 실행 옵션에 플래그를 추가해야 합니다.

alias 등록 (한 번만 하면 됩니다)
# ~/.bashrc에 alias 추가 echo 'alias code="code --enable-features=UseOzonePlatform --ozone-platform=x11"' >> ~/.bashrc source ~/.bashrc

이제 터미널에서 code만 쳐도 한글 입력이 되는 상태로 실행됩니다.

🔧 Git 설치 및 초기 설정

대부분의 리눅스에는 Git이 이미 설치되어 있지만, 없다면 먼저 설치합니다.

sudo apt install git git --version # 버전 번호가 뜨면 정상
기본 정보 등록
git config --global user.name "이름" git config --global user.email "이메일@주소.com" git config --global core.editor "code --wait" # 기본 에디터를 VS Code로 git config --list # 설정 확인
GitHub SSH 키 등록

매번 비밀번호를 입력하지 않으려면 SSH 키를 등록해두는 게 편합니다.

  • 1
    SSH 키 생성 ssh-keygen -t ed25519 -C "이메일@주소.com" # 경로·비밀번호 묻는 창은 엔터로 넘겨도 됨
  • 2
    공개 키 복사 cat ~/.ssh/id_ed25519.pub # 출력된 내용 전체 복사
  • 3
    GitHub → Settings → SSH and GPG keys → New SSH key → 붙여넣기
  • 4
    연결 테스트 ssh -T git@github.com # "Hi 사용자명! You've successfully authenticated" 뜨면 성공
🐍 Python 개발 환경 세팅

Xubuntu 24.04에는 Python 3가 기본 설치되어 있어요. pip와 venv만 추가로 설치하면 됩니다.

python3 --version # 버전 확인 sudo apt install python3-pip python3-venv
가상환경(venv) 사용하기

프로젝트마다 가상환경을 만들어 쓰는 게 좋습니다. 패키지 충돌을 방지할 수 있어요.

# 프로젝트 폴더 만들고 이동 mkdir myproject && cd myproject # 가상환경 생성 python3 -m venv venv # 가상환경 활성화 source venv/bin/activate # 비활성화 deactivate

가상환경이 활성화되면 터미널 프롬프트 앞에 (venv) 표시가 생겨요. 이 상태에서 pip로 설치하면 이 환경에만 적용됩니다.

VS Code에서 Python 인터프리터 설정

VS Code에서 Python 파일을 열면 오른쪽 하단에 Python 버전이 표시됩니다. 클릭해서 가상환경의 venv/bin/python 경로를 선택하면 돼요.

🟩 Node.js 설치

apt로 직접 설치하기보다 nvm(Node Version Manager)으로 설치하는 걸 추천합니다. 나중에 버전 전환이 필요할 때 훨씬 편거든요.

nvm 설치
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # 설치 후 터미널 재시작 또는 아래 명령어 실행 source ~/.bashrc # 설치 확인 nvm --version
Node.js 설치
# 최신 LTS 버전 설치 nvm install --lts # 버전 확인 node --version npm --version
자주 쓰는 전역 패키지
npm install -g yarn # 패키지 매니저 npm install -g typescript # TypeScript 컴파일러
🔌 VS Code 추천 확장 프로그램
확장 이름 용도 중요도
Python (Microsoft) 파이썬 개발 필수 필수
Pylance 자동완성, 타입 체크 필수
ESLint JavaScript 코드 품질 추천
Prettier 코드 자동 포맷 추천
GitLens Git 히스토리 시각화 추천
Korean Language Pack VS Code 한국어 UI 추천
Remote - SSH 원격 서버 접속 추천
Thunder Client REST API 테스트 추천

Korean Language Pack은 VS Code 인터페이스를 한국어로 바꿔줍니다. 처음엔 편하지만 익숙해지면 영어 UI가 검색하기 더 쉬울 수 있어요. 취향껏 선택하세요.

📋 전체 세팅 순서 한눈에 보기
# 내용 명령어 / 방법
01 VS Code 설치 .deb 파일 또는 snap
02 한글 입력 alias 등록 ~/.bashrc 수정
03 Git 설치 및 설정 git config --global
04 GitHub SSH 키 등록 ssh-keygen -t ed25519
05 Python + pip + venv sudo apt install python3-pip python3-venv
06 nvm + Node.js 설치 nvm install --lts
07 VS Code 확장 설치 Extensions 탭에서 검색

크롬북(Core M, 8GB)에서 이 환경으로 실제로 코딩해봤는데, 생각보다 훨씬 잘 돌아갑니다. VS Code도 무겁지 않고, Python이나 Node.js 작업도 막힘 없이 돼요. 리눅스에서 개발 환경을 직접 세팅하다 보면 윈도우·맥에서는 당연하게 쓰던 것들이 어떻게 돌아가는지 이해가 되기 시작합니다. 처음엔 번거롭게 느껴지지만, 이게 또 리눅스 개발 환경의 재미이기도 해요.

세팅하다 막힌 부분이 있으면 댓글로 남겨주세요 😊

아는 범위 내에서 같이 해결해 볼게요.