이 출시되었습니다! 11월의 새로운 기능 및 수정 사항을 읽어보세요.

Linux용 Visual Studio Code

설치

  1. Linux 배포판용 Visual Studio Code 다운로드 및 설치

    참고

    VS Code는 월별 릴리스를 제공하며 새로운 릴리스가 나올 때 자동 업데이트를 지원합니다.

  2. 추가 구성 요소 설치

    Git, Node.js, TypeScript, 언어 런타임 등을 설치합니다.

  3. Visual Studio Marketplace에서 VS Code 확장 설치

    선호하는 언어에 대한 테마, 포맷터, 언어 확장 및 디버거 등으로 VS Code를 사용자 지정합니다.

  4. AI 기능 활성화

    팁

    아직 Copilot 구독이 없다면 Copilot 무료 플랜에 가입하여 Copilot을 무료로 사용할 수 있으며, 월별 완료 횟수 및 채팅 상호 작용 제한이 제공됩니다.

  5. VS Code 튜토리얼로 시작하기

    VS Code의 사용자 인터페이스 및 주요 기능을 살펴봅니다.

Linux에 VS Code 설치

Debian 및 Ubuntu 기반 배포판

  1. Debian/Ubuntu 기반 배포판에 Visual Studio Code를 설치하는 가장 쉬운 방법은 .deb 패키지(64비트)를 다운로드하여 설치하는 것입니다. 그래픽 소프트웨어 센터를 사용할 수 있다면 이를 통해 설치하거나, 명령줄에서는 다음과 같이 설치합니다.

    sudo apt install ./<file>.deb

# If you're on an older Linux distribution, you will need to run this instead:
# sudo dpkg -i <file>.deb
# sudo apt-get install -f # Install dependencies
    참고

    다른 바이너리도 VS Code 다운로드 페이지에서 사용할 수 있습니다.

    .deb 패키지를 설치하면 시스템 패키지 관리자를 사용하여 자동 업데이트를 활성화하기 위해 apt 저장소와 서명 키를 설치할지 묻는 메시지가 표시됩니다.

  2. 비대화식 터미널 등에서 apt 저장소와 서명 키를 자동으로 설치하려면 먼저 다음 명령을 실행합니다.

    echo "code code/add-microsoft-repo boolean true" | sudo debconf-set-selections

  3. apt 저장소를 수동으로 설치하려면

    1. 다음 스크립트를 실행하여 서명 키를 설치합니다.

      sudo apt-get install wget gpg &&
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg &&
sudo install -D -o root -g root -m 644 microsoft.gpg /usr/share/keyrings/microsoft.gpg &&
rm -f microsoft.gpg

    2. 업스트림 패키지 저장소에 대한 참조를 추가하기 위해 다음 내용으로 /etc/apt/sources.list.d/vscode.sources 파일을 만듭니다.

      Types: deb
URIs: https://packages.microsoft.com/repos/code
Suites: stable
Components: main
Architectures: amd64,arm64,armhf
Signed-By: /usr/share/keyrings/microsoft.gpg

    3. 마지막으로 패키지 캐시를 업데이트하고 패키지를 설치합니다.

      sudo apt install apt-transport-https &&
sudo apt update &&
sudo apt install code # or code-insiders
참고

수동 서명 프로세스와 저희가 사용하는 게시 시스템으로 인해 Debian 저장소는 최대 3시간까지 지연될 수 있으며 VS Code의 최신 버전을 즉시 가져오지 못할 수 있습니다.

RHEL, Fedora 및 CentOS 기반 배포판

현재 RHEL, Fedora 또는 CentOS 기반 배포판용 64비트 안정 버전 VS Code를 yum 저장소에서 제공합니다.

  1. 다음 스크립트를 실행하여 키와 yum 저장소를 설치합니다.

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc &&
echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\nautorefresh=1\ntype=rpm-md\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/yum.repos.d/vscode.repo > /dev/null

  2. 그런 다음 패키지 캐시를 업데이트하고 dnf(Fedora 22 이상)를 사용하여 패키지를 설치합니다.

    dnf check-update &&
sudo dnf install code # or code-insiders

    또는 이전 버전에서는 yum을 사용합니다.

    yum check-update &&
sudo yum install code # or code-insiders
참고

수동 서명 프로세스와 저희가 사용하는 게시 시스템으로 인해 yum 저장소는 최대 3시간까지 지연될 수 있으며 VS Code의 최신 버전을 즉시 가져오지 못할 수 있습니다.

Snap

VS Code는 Snap Store의 Snap 패키지로 공식 배포됩니다.

Get it from the Snap Store

다음 명령을 실행하여 설치할 수 있습니다.

sudo snap install --classic code # or code-insiders

설치 후 Snap 데몬이 백그라운드에서 VS Code를 자동으로 업데이트합니다. 새 업데이트를 사용할 수 있을 때마다 제품 내 업데이트 알림을 받게 됩니다.

참고

snap이 Linux 배포판에 없는 경우 snapd 설치 가이드를 확인하여 설정을 도울 수 있습니다.

snap에 대한 자세한 내용은 공식 Snap 설명서에서 알아보세요.

openSUSE 및 SLE 기반 배포판

앞서 언급한 yum 저장소는 openSUSE 및 SLE 기반 시스템에서도 작동합니다.

  1. 다음 스크립트를 실행하여 키와 yum 저장소를 설치합니다.

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc &&
echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\nautorefresh=1\ntype=rpm-md\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/zypp/repos.d/vscode.repo > /dev/null

  2. 그런 다음 패키지 캐시를 업데이트하고 다음을 사용하여 패키지를 설치합니다.

    sudo zypper install code

Arch Linux용 AUR 패키지

커뮤니티에서 유지 관리하는 VS Code용 Arch 사용자 저장소 패키지가 있습니다.

AUR에서 설치에 대한 자세한 내용을 보려면 다음 위키 항목을 참조하십시오: AUR 패키지 설치.

NixOS(또는 Nix 패키지 관리자를 사용하는 모든 Linux 배포판)용 Nix 패키지

nixpkgs 저장소에는 커뮤니티에서 유지 관리하는 VS Code Nix 패키지가 있습니다.

Nix를 사용하여 설치하려면

  1. config.nix에서 allowUnfree 옵션을 true로 설정합니다.

  2. 다음 명령을 실행합니다.

    nix-env -i vscode

.rpm 패키지 수동 설치

VS Code .rpm 패키지(64비트)를 수동으로 다운로드하여 설치할 수 있습니다. 그러나 위의 저장소가 설치되지 않으면 자동 업데이트가 작동하지 않습니다.

다운로드 후에는 패키지 관리자를 사용하여 .rpm 패키지를 설치할 수 있습니다. 예를 들어 dnf를 사용합니다.

sudo dnf install <file>.rpm
참고

다른 바이너리도 VS Code 다운로드 페이지에서 사용할 수 있습니다.

업데이트

VS Code는 월별로 릴리스되며 릴리스 노트를 확인하여 새 릴리스를 언제 사용할 수 있는지 확인할 수 있습니다. VS Code 저장소가 올바르게 설치되었다면 시스템 패키지 관리자가 시스템의 다른 패키지와 동일한 방식으로 자동 업데이트를 처리해야 합니다.

참고

Snap 패키지의 경우 업데이트가 자동이며 백그라운드에서 실행됩니다.

VS Code를 기본 텍스트 편집기로 설정

xdg-open

xdg-open에서 사용하는 텍스트 파일(text/plain)의 기본 텍스트 편집기를 다음 명령으로 설정할 수 있습니다.

xdg-mime default code.desktop text/plain

Debian alternatives 시스템

Debian 기반 배포판에서는 MIME 유형에 관계없이 Debian alternatives 시스템을 사용하여 기본 편집기를 설정할 수 있습니다. 다음 명령을 실행하고 code를 선택하여 설정할 수 있습니다.

sudo update-alternatives --set editor /usr/bin/code

VS Code가 기본 editor의 대체 항목으로 표시되지 않으면 등록해야 합니다.

sudo update-alternatives --install /usr/bin/editor editor $(which code) 10

사용자 지정 제목 표시줄 사용

사용자 지정 제목 표시줄은 훌륭한 테마 지원 및 키보드 탐색 및 화면 판독기를 통한 접근성 개선 등 많은 이점을 제공합니다. 이러한 이점은 Linux 플랫폼에 항상 잘 적용되지 않을 수 있습니다. Linux에는 다양한 데스크톱 환경 및 창 관리자가 있어 VS Code 테마가 사용자에게 낯설게 보일 수 있습니다. 따라서 Linux에서는 사용자 지정 제목 표시줄이 기본적으로 활성화되어 있지 않습니다.

접근성 향상이 필요한 사용자는 화면 판독기를 사용하여 접근성 모드에서 실행할 때 사용자 지정 제목 표시줄을 활성화하는 것이 좋습니다.

창: 제목 표시줄 스타일(window.titleBarStyle) 설정을 사용하여 제목 표시줄을 수동으로 구성할 수 있습니다.

  • custom: 사용자 지정 제목 표시줄을 사용합니다.
  • native: 운영 체제의 제목 표시줄을 사용합니다.

Linux 개발 머신으로 Windows 사용

VS Code로 Linux 개발을 위한 또 다른 옵션은 Windows Subsystem for Linux(WSL)을 사용하여 Windows 머신을 사용하는 것입니다.

Linux용 Windows 하위 시스템

WSL을 사용하면 Windows에서 Linux 배포판을 설치하고 실행하여 Windows 머신에서 로컬로 작업하면서 Linux에서 소스 코드를 개발하고 테스트할 수 있습니다. WSL은 Microsoft Store에서 제공되는 Ubuntu, Debian, SUSE 및 Alpine과 같은 Linux 배포판을 지원합니다.

WSL 확장과 함께 사용하면 WSL의 Linux 배포판 컨텍스트에서 실행되는 동안 전체 VS Code 편집 및 디버깅 지원을 받을 수 있습니다.

WSL에서의 개발에 대한 자세한 내용은 WSL에서의 개발 설명서를 참조하거나 WSL에서의 작업 소개 자습서를 시도해 보세요.

다음 단계

VS Code를 설치한 후 다음 항목을 통해 자세히 알아볼 수 있습니다.

  • VS Code 튜토리얼 - VS Code의 주요 기능에 대한 빠른 실습 투어입니다.
  • 팁 및 요령 - VS Code 작업에 대한 생산성 팁 모음입니다.
  • AI 기반 코딩 - 코드를 더 빠르게 작성하는 데 도움이 되는 VS Code에서 GitHub Copilot 사용에 대해 알아봅니다.

자주 묻는 질문

Debian 및 파일 이동 시 휴지통

Debian 운영 체제에서 VS Code 탐색기에서 파일을 삭제할 때 오류가 발생하면 VS Code에서 사용하는 휴지통 구현이 없기 때문일 수 있습니다.

이 문제를 해결하려면 이 명령을 실행합니다.

sudo apt-get install gvfs libglib2.0-bin

다른 저장소의 VS Code 패키지와 충돌

예를 들어 Pop!_OS와 같은 일부 배포판은 자체 code 패키지를 제공합니다. 공식 VS Code 저장소가 사용되도록 하려면 다음 내용으로 /etc/apt/preferences.d/code라는 파일을 만듭니다.

Package: code
Pin: origin "packages.microsoft.com"
Pin-Priority: 9999

"Visual Studio Code는 이 대형 작업 영역에서 파일 변경을 감시할 수 없습니다"(오류 ENOSPC)

이 알림이 표시되면 VS Code 파일 감시자가 파일 감시를 구현하는 데 필요한 파일 핸들이 부족하다는 것을 나타냅니다. 가장 흔한 경우는 대규모 작업 영역을 열고 파일이 많은 경우입니다. 플랫폼 제한을 조정하기 전에 Python .venv와 같이 잠재적으로 큰 폴더가 files.watcherExclude 설정에 추가되었는지 확인하세요(자세한 내용은 아래 참조). 또한 다른 실행 중인 애플리케이션이 너무 많은 파일 핸들을 소비하여 VS Code에서 사용할 수 있는 핸들이 남지 않는 경우도 있습니다. 이 경우 해당 다른 애플리케이션을 닫는 것이 도움이 될 수 있습니다.

현재 제한은 다음을 실행하여 확인할 수 있습니다.

cat /proc/sys/fs/inotify/max_user_watches

/etc/sysctl.conf를 편집하고(Arch Linux 및 Ubuntu 24.10 이상 제외, 아래 참조) 파일 끝에 다음 줄을 추가하여 제한을 최대로 늘릴 수 있습니다.

fs.inotify.max_user_watches=524288

그런 다음 sudo sysctl -p를 실행하여 새 값을 로드할 수 있습니다.

524,288이 감시할 수 있는 최대 파일 수이지만, 메모리 제한이 엄격한 환경이라면 숫자를 줄이고 싶을 수 있습니다. 각 파일 감시는 1,080바이트를 차지하므로, 524,288개의 감시가 모두 사용되었다고 가정하면 최대 540MiB 정도가 됩니다.

Arch 기반 배포판(Manjaro 포함) 및 24.10부터 시작하는 Ubuntu 기반 배포판에서는 다른 파일을 변경해야 합니다. 대신 이 단계를 따르세요.

또 다른 옵션은 files.watcherExclude 설정을 사용하여 VS Code 파일 감시에서 특정 작업 영역 디렉토리를 제외하는 것입니다. files.watcherExclude의 기본값은 node_modules 및 .git 아래의 일부 폴더를 제외하지만, VS Code에서 추적하지 않으려는 다른 디렉토리를 추가할 수 있습니다.

"files.watcherExclude": {
    "**/.git/objects/**": true,
    "**/.git/subtree-cache/**": true,
    "**/node_modules/*/**": true
  }

Ubuntu에서 중국어 문자가 보이지 않습니다.

수정 중입니다. 그동안 애플리케이션 메뉴를 열고 파일 > 기본 설정 > 설정을 선택합니다. 텍스트 편집기 > 글꼴 섹션에서 "글꼴 패밀리"를 Droid Sans Mono, Droid Sans Fallback으로 설정합니다. settings.json 파일을 직접 편집하려면 다음 그림과 같이 editor.fontFamily를 설정합니다.

    "editor.fontFamily": "Droid Sans Mono, Droid Sans Fallback"

git 패키지가 설치되지 않았습니다.

이 오류는 설치 중에 나타날 수 있으며 일반적으로 패키지 관리자 목록이 최신이 아닐 때 발생합니다. 목록을 업데이트하고 다시 설치해 보세요.

# For .deb
sudo apt-get update

# For .rpm (Fedora 21 and below)
sudo yum check-update

# For .rpm (Fedora 22 and above)
sudo dnf check-update

code bin 명령이 Ubuntu에서 창을 전면으로 가져오지 않습니다.

현재 디렉터리에 VS Code가 이미 열려 있는 상태에서 Ubuntu에서 code .를 실행하면 VS Code가 전면으로 가져와지지 않습니다. 이것은 CCMS를 사용하여 비활성화할 수 있는 OS 기능입니다.

# Install
sudo apt-get update
sudo apt-get install compizconfig-settings-manager

# Run
ccsm

일반 > 일반 옵션 > 포커스 및 올리기 동작에서 "포커스 방지 수준"을 "끔"으로 설정합니다. 이것은 VS Code뿐만 아니라 모든 애플리케이션에 적용되는 OS 수준 설정이라는 점을 기억하세요.

"/etc/apt/sources.list.d/vscode.list: 해당 파일 또는 디렉토리가 없습니다" 때문에 .deb 패키지를 설치할 수 없습니다.

sources.list.d가 없거나 파일을 만들 액세스가 없을 때 발생할 수 있습니다. 이를 해결하려면 폴더와 빈 vscode.list 파일을 수동으로 만드는 것을 시도해 보세요.

sudo mkdir /etc/apt/sources.list.d
sudo touch /etc/apt/sources.list.d/vscode.list

원격 창을 X 전달하는 동안 창 이동 또는 크기 조정 불가

원격으로 VS Code를 사용하기 위해 X 전달을 사용하고 있다면, 창을 올바르게 조작할 수 있도록 네이티브 제목 표시줄을 사용해야 합니다. window.titleBarStyle를 native로 설정하여 전환할 수 있습니다.

저장소의 origin 값이 변경되었습니다.

다음과 유사한 오류가 발생하는 경우

E: Repository '...' changed its 'Origin' value from '...' to '...'
N: This must be accepted explicitly before updates for this repository can be applied. See apt-secure(8) manpage for details.

apt-get 대신 apt를 사용하면 origin 변경을 수락하라는 메시지가 표시됩니다.

sudo apt update
12/10/2025
English 한국어 中文(简体)
© . This site is unofficial and not affiliated with Microsoft.