LightNode 로고

우분투에 VS Code 설치하는 방법

LightNode
작성자 LightNode · · 업데이트 2026-07-12

빠른 답변: 우분투에 VS Code를 설치하는 가장 빠른 방법

우분투(26.04 LTS, 24.04 LTS 또는 22.04 LTS)에 Visual Studio Code를 설치하는 가장 빠른 방법은 단일 Snap 명령어를 실행하거나, 공식 .deb 파일을 다운로드하여 apt로 설치하는 것입니다. 아래 세 가지 방법 모두 현재 우분투 릴리스에서 작동합니다:

  1. Snap (명령어 하나, 자동 업데이트):

    sudo snap install code --classic

  2. 공식 .deb 패키지 — code.visualstudio.com에서 다운로드한 다음 apt로 직접 설치합니다(이 방법은 마이크로소프트 저장소도 함께 추가하므로 VS Code가 시스템과 함께 업데이트됩니다):

    sudo apt install ./code_*_amd64.deb

  3. 마이크로소프트 APT 저장소 (스크립트/서버 설정에 가장 적합) — 마이크로소프트 서명 키와 저장소를 추가한 다음 code를 설치합니다:

    sudo apt install wget gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft.gpg
echo "deb [arch=amd64,arm64,armhf signed-by=/usr/share/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list > /dev/null
sudo apt update && sudo apt install code

설치 후에는 터미널에 code를 입력하거나 애플리케이션 메뉴에서 열어 VS Code를 실행하세요. 각 방법의 상세한 단계별 안내(설치 후 설정 및 문제 해결 포함)는 아래에 있습니다.

소개

Visual Studio Code(VSCode)는 마이크로소프트에서 개발한 강력하고 다재다능하며 무료인 소스 코드 편집기입니다. 가벼운 성능, 광범위한 기능 세트, 그리고 확장 프로그램의 견고한 생태계 덕분에 개발자들 사이에서 큰 인기를 얻고 있습니다. VSCode는 다양한 프로그래밍 언어와 프레임워크를 지원하여 초보자와 숙련된 개발자 모두에게 이상적인 선택입니다.

우분투 사용자에게 VSCode 설치는 코드 편집, 디버깅, 버전 관리 통합 측면에서 무한한 가능성을 열어줍니다. 웹 개발자, 데이터 과학자, 시스템 관리자 등 누구든 VSCode를 통해 생산성을 크게 향상시키고 작업 흐름을 간소화할 수 있습니다.

이 가이드에서는 우분투에 Visual Studio Code를 설치하는 과정을 단계별로 안내합니다. 여러 설치 방법을 다루어 우분투 운영체제에 대한 숙련도와 필요에 맞는 방법을 선택할 수 있도록 도와드립니다.

사전 준비 사항

설치 과정을 시작하기 전에 우분투 시스템에 Visual Studio Code를 성공적으로 설치하기 위해 필요한 사항들을 확인해봅시다. 사전 준비 사항은 다음과 같습니다:

  1. 우분투 운영체제:

    • VSCode는 우분투 26.04 LTS(Resolute Raccoon, 2026년 4월 23일 출시), 24.04 LTS(Noble Numbat), 22.04 LTS(Jammy Jellyfish)를 비롯해 현재 지원되는 모든 우분투 릴리스와 최신 비LTS 릴리스에서 실행됩니다. 우분투 20.04 LTS도 여전히 작동하지만, 표준 지원이 2025년 5월 31일에 종료되어 이제는 확장 보안 유지 관리(Expanded Security Maintenance, Ubuntu Pro)를 통해서만 업데이트를 받습니다.
    • 우분투 18.04 LTS는 더 이상 지원되지 않습니다. VS Code 1.86(2024년 1월)부터 편집기는 glibc 2.28 이상을 요구하는데, 18.04는 glibc 2.27을 탑재하고 있어 더 이상 최신 빌드를 실행할 수 없습니다. 18.04에서 작동하는 마지막 릴리스는 버전 1.85입니다.
    • 터미널에서 sudo apt update && sudo apt upgrade 명령어를 실행하여 우분투 시스템을 최신 상태로 유지하세요.

  2. 인터넷 연결:

    • VSCode 및 의존성 파일 다운로드를 위해 안정적인 인터넷 연결이 필요합니다.
    • 데이터 요금제를 사용 중이라면 현재 .deb 다운로드 크기가 약 190MB임을 참고하세요.

  3. 기본 터미널 지식:

    • 일부 설치 방법은 명령어 사용이 필요합니다.
    • 기본적인 터미널 명령어에 익숙하면 도움이 됩니다.

  4. sudo 권한:

    • 우분투 시스템에 소프트웨어를 설치하려면 sudo 권한이 필요합니다.
    • 시스템의 sudo 비밀번호를 알고 있어야 합니다.

  5. 충분한 디스크 공간:

    • VSCode는 설치 후 약 400MB의 디스크 공간을 차지합니다.
    • 시스템에 충분한 여유 공간이 있는지 확인하세요.

  6. 지원되는 아키텍처:

    • VSCode는 64비트 시스템을 지원합니다.
    • 터미널에서 uname -m 명령어를 실행하여 시스템 아키텍처를 확인하세요. 결과가 x86_64여야 합니다.

방법 1: 우분투 소프트웨어 센터에서 VSCode 설치하기

우분투 소프트웨어 센터는 그래픽 인터페이스를 제공하여 시각적인 방법을 선호하는 사용자에게 적합합니다. 다음은 이 방법으로 Visual Studio Code를 설치하는 절차입니다:

  1. 우분투 소프트웨어 센터 열기:

    • 도크에서 우분투 소프트웨어 아이콘을 클릭하거나 활동 개요에서 "Ubuntu Software"를 검색하세요.

  2. VSCode 검색하기:

    • 소프트웨어 센터가 열리면 상단 검색창을 클릭합니다.
    • "Visual Studio Code" 또는 "VSCode"를 입력하고 Enter 키를 누르세요.

  3. Visual Studio Code 찾기:

    • 검색 결과에서 Visual Studio Code를 찾을 수 있습니다.
    • 일반적으로 공식 VSCode 아이콘과 Microsoft가 게시자로 표시됩니다.

  4. VSCode 설치하기:

    • Visual Studio Code 항목을 클릭하여 상세 페이지를 엽니다.
    • "설치" 버튼을 클릭하세요.
    • 설치 권한을 위해 비밀번호 입력을 요청받을 수 있습니다.

  5. 설치 완료까지 기다리기:

    • 소프트웨어 센터가 VSCode를 다운로드하고 설치합니다.
    • 인터넷 속도에 따라 몇 분 정도 소요됩니다.

  6. VSCode 실행하기:

    • 설치가 완료되면 소프트웨어 센터에서 "실행" 버튼을 클릭할 수 있습니다.
    • 또는 애플리케이션 메뉴에서 VSCode를 찾거나 활동 개요에서 검색하세요.

방법 2: APT를 사용하여 VSCode 설치하기

APT(Advanced Package Tool)를 사용한 설치는 마이크로소프트의 공식 저장소에서 최신 버전을 직접 받을 수 있는 보다 견고한 방법입니다. 이 방법은 공식 저장소를 시스템에 추가하는 과정을 포함합니다. 절차는 다음과 같습니다:

  1. 패키지 인덱스 업데이트: 터미널을 열고 다음 명령어를 실행하여 패키지 인덱스를 최신 상태로 만듭니다:

    sudo apt update

  2. 필요한 의존성 설치: 다음 명령어로 필요한 의존성을 설치하세요:

    sudo apt install wget gpg apt-transport-https

  3. 마이크로소프트 GPG 키 가져오기: 마이크로소프트 GPG 키를 가져와 최신 keyrings 디렉터리에 저장합니다. (구형 apt-key add 명령어는 더 이상 사용되지 않으며 우분투 22.04 이상에서는 작동하지 않으므로, 대신 gpg --dearmor를 사용하세요):

    wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft.gpg

  4. VSCode 저장소 추가: 방금 추가한 키를 참조하여 공식 VS Code 저장소를 활성화합니다:

    echo "deb [arch=amd64,arm64,armhf signed-by=/usr/share/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list > /dev/null

  5. 패키지 인덱스 다시 업데이트: 새 저장소를 추가한 후 패키지 인덱스를 다시 업데이트합니다:

    sudo apt update

  6. VSCode 설치: 마지막으로 Visual Studio Code를 설치합니다:

    sudo apt install code

  7. 설치 확인: 설치가 완료되면 버전을 확인하여 설치를 검증할 수 있습니다:

    code --version

이 방법의 장점은 다음과 같습니다:

  • 항상 최신 버전의 VSCode를 사용할 수 있습니다.
  • 우분투의 표준 업데이트 프로세스를 통해 업데이트가 관리됩니다.
  • 시스템 설정 스크립트에 자동화하기 쉽습니다.

방법 3: .deb 패키지를 사용하여 VSCode 설치하기

.deb 패키지를 이용한 설치는 또 다른 간단한 방법입니다. 이 방법은 패키지를 먼저 다운로드하여 나중에 설치하거나 인터넷이 없는 환경에서 설치할 때 유용합니다. 절차는 다음과 같습니다:

  1. .deb 패키지 다운로드:

    • 웹 브라우저를 열고 공식 Visual Studio Code 웹사이트(https://code.visualstudio.com/)로 이동합니다.
    • Linux용 다운로드 버튼을 클릭합니다.
    • 우분투/데비안용 .deb 패키지를 선택합니다.
    • 다운로드가 자동으로 시작됩니다.

  2. 다운로드한 파일 위치 확인:

    • 기본적으로 파일은 Downloads 폴더에 저장됩니다.
    • 파일명은 code_1.XX.X-XXXXXXXXXX_amd64.deb 형식이며, X는 버전 번호를 나타냅니다.

  3. GUI를 사용한 설치 (옵션 1):

    • 다운로드가 완료되면 .deb 파일을 더블 클릭합니다.
    • 우분투 소프트웨어 센터가 열립니다.
    • "설치" 버튼을 클릭하세요.
    • 설치 권한을 위해 비밀번호를 입력합니다.

  4. 터미널을 사용한 설치 (옵션 2):

    • 터미널을 선호한다면, 권장 방법은 의존성을 자동으로 해결해 주는 apt로 .deb 패키지를 설치하는 것입니다: 
      sudo apt install ~/Downloads/code_1.XX.X-XXXXXXXXXX_amd64.deb
    • X 부분을 실제 다운로드한 파일의 버전 번호로 바꾸세요(현재 1.128 릴리스의 경우 파일명은 code_1.128.0-XXXXXXXXXX_amd64.deb 형태이며, 뒤쪽 숫자는 다운로드 페이지에 표시되는 빌드 타임스탬프입니다). 이 방법은 마이크로소프트 저장소도 함께 추가하므로 VS Code가 apt를 통해 계속 업데이트됩니다.
    • 또는 dpkg를 사용한 뒤 누락된 의존성을 해결할 수도 있습니다: 
      sudo dpkg -i ~/Downloads/code_1.XX.X-XXXXXXXXXX_amd64.deb
sudo apt install -f

  5. 설치 확인:

    • 설치 후 애플리케이션 메뉴에서 VSCode를 열거나 터미널에서 code 명령어를 실행하여 확인할 수 있습니다.

이 방법의 장점은 다음과 같습니다:

  • 다른 컴퓨터에서 .deb 파일을 다운로드해 오프라인 설치가 가능합니다.
  • 설치할 버전을 직접 선택할 수 있습니다.
  • 조직 내 대량 배포에 유용합니다.

방법 4: Snap을 사용하여 VSCode 설치하기

Snap 패키지는 우분투 26.04, 24.04, 22.04에서 기본으로 지원되므로, 이 방법은 명령어 하나로 끝나는 가장 빠른 옵션입니다. VS Code snap은 마이크로소프트가 게시하고 관리하며, 백그라운드에서 자동으로 최신 상태를 유지합니다. 사용 방법은 다음과 같습니다:

  1. Snap으로 VSCode 설치: 터미널을 열고 다음을 실행합니다:

    sudo snap install code --classic

    --classic 플래그는 VS Code가 일반적인 snap 샌드박스 밖에서 파일을 편집하고 도구를 실행하기 위해 시스템에 폭넓은 접근이 필요하기 때문에 요구됩니다.

  2. 설치 확인: 버전을 확인하여 설치를 검증합니다:

    code --version

이 방법의 장점은 다음과 같습니다:

  • 저장소 설정이 필요 없는 단일 명령어입니다.
  • 업데이트가 백그라운드에서 자동으로 적용됩니다.
  • 현재 우분투 릴리스 전반에서 동일하게 작동합니다.

설치 후 단계

우분투 시스템에 Visual Studio Code를 성공적으로 설치한 후, 최상의 사용 경험을 위해 다음 단계를 수행할 수 있습니다:

  1. VSCode 실행하기:

    • 여러 방법으로 VSCode를 실행할 수 있습니다:
      • 애플리케이션 메뉴에서 VSCode 아이콘 클릭
      • 활동 개요에서 "Visual Studio Code" 검색
      • 터미널에서 code 입력 후 Enter

  2. 명령줄 통합 설정하기:

    • 터미널에서 VSCode를 실행해 파일이나 폴더를 열 수 있습니다.
    • 이 기능을 활성화하려면 VSCode를 연 뒤 다음을 수행하세요:
      1. Ctrl+Shift+P를 눌러 명령 팔레트를 엽니다.
      2. "shell command"를 입력하고 "Shell Command: Install 'code' command in PATH"를 선택합니다.
    • 이후 code . 같은 명령어로 현재 디렉터리를 VSCode에서 열 수 있습니다.

  3. 확장 프로그램 설치하기:

    • VSCode 기능을 확장하려면 확장 프로그램을 설치하세요.
    • 설치 방법:
      1. 왼쪽 사이드바의 확장 아이콘 클릭(또는 Ctrl+Shift+X 단축키)
      2. 필요한 확장 프로그램 검색(예: Python, C++, JavaScript)
      3. 원하는 확장 프로그램 옆의 "설치" 버튼 클릭

  4. 설정 구성하기:

    • VSCode를 원하는 대로 맞춤 설정하세요:
      1. 파일 > 기본 설정 > 설정으로 이동(또는 Ctrl+, 단축키)
      2. 테마, 글꼴 크기, 들여쓰기 등 다양한 설정을 조정할 수 있습니다.

  5. VSCode 업데이트하기:

    • APT 또는 소프트웨어 센터를 통해 설치한 경우:
      • 시스템 업데이트 시 자동으로 VSCode도 업데이트됩니다.
      • 수동으로 업데이트 확인하려면 다음 명령어를 실행하세요: 
        sudo apt update
sudo apt upgrade
    • .deb 패키지로 설치한 경우:
      • 새 버전을 직접 다운로드하여 설치해야 합니다.
      • 업데이트가 있을 때 VSCode가 알림을 제공합니다.

  6. 키보드 단축키 배우기:

    • VSCode에는 유용한 키보드 단축키가 많습니다.
    • 모든 단축키는 파일 > 기본 설정 > 키보드 단축키에서 확인할 수 있습니다.
    • 인기 있는 단축키 예시:
      • Ctrl+P: 빠른 파일 열기
      • Ctrl+Shift+P: 명령 팔레트
      • Ctrl+/: 줄 주석 토글

우분투에 VSCode 설치하기

자주 묻는 질문 (FAQ)

Q: Visual Studio Code는 무료인가요?

A: 네, Visual Studio Code는 무료이자 오픈 소스 소프트웨어입니다. 비용 없이 사용할 수 있습니다.

Q: 마이크로소프트가 만든 언어 외에도 VSCode를 사용할 수 있나요?

A: 물론입니다! VSCode는 확장 가능한 시스템을 통해 다양한 프로그래밍 언어를 지원합니다. Python, Java, C++, Ruby 등 여러 언어용 확장 프로그램을 찾을 수 있습니다.

Q: 더 이상 VSCode가 필요 없으면 어떻게 제거하나요?

A: 터미널에서 다음 명령어로 VSCode를 제거할 수 있습니다:

sudo apt remove code

.deb 패키지로 설치한 경우 다음 명령어를 사용할 수 있습니다:

sudo dpkg -r code

Q: VSCode가 내 프로그래밍 언어를 인식하지 못해요. 어떻게 해야 하나요?

A: 적절한 언어 확장 프로그램을 설치해야 할 수 있습니다. VSCode를 열고 확장 뷰(Ctrl+Shift+X)로 이동하여 해당 언어를 검색하고 설치하세요.

Q: 여러 컴퓨터에서 VSCode 설정을 동기화할 수 있나요?

A: 네, VSCode는 설정 동기화 기능을 제공합니다. 왼쪽 하단의 톱니바퀴 아이콘을 클릭하고 "설정 동기화 켜기"를 선택하면 활성화할 수 있습니다.

Q: VSCode는 얼마나 자주 업데이트되나요?

A: 마이크로소프트는 보통 매월 VSCode 업데이트를 출시합니다. 업데이트에는 버그 수정, 성능 개선, 새로운 기능이 포함됩니다.

Q: VSCode를 원격 개발에 사용할 수 있나요?

A: 네, VSCode는 원격 개발 확장팩을 통해 컨테이너, 원격 머신, Windows Subsystem for Linux(WSL)를 완전한 개발 환경으로 사용할 수 있습니다.

Q: VSCode와 Visual Studio는 같은 건가요?

A: 아닙니다. VSCode(Visual Studio Code)는 가볍고 크로스 플랫폼 코드 편집기이며, Visual Studio는 주로 윈도우용 통합 개발 환경(IDE)입니다.

Q: VSCode 개발에 기여할 수 있나요?

A: 네, VSCode는 오픈 소스이며 마이크로소프트는 기여를 환영합니다. GitHub 저장소에서 소스 코드와 기여 가이드를 확인할 수 있습니다.

Q: VSCode 시스템 트레이 아이콘이 사라졌어요. 어떻게 해결하나요?

A: 일부 리눅스 배포판에서 알려진 문제입니다. 다음 명령어로 `libappindicator1` 패키지를 설치해 보세요:
```
sudo apt install libappindicator1
```
그래도 해결되지 않으면 "TopIcons Plus" 같은 GNOME 셸 확장 프로그램을 사용하여 아이콘을 표시할 수 있습니다.
목록으로 돌아가기