Ubuntu에서 VS Code 완전 정복: 설치·일본어화·추천 설정·개발 환경 구축 가이드

1. 소개: 왜 Ubuntu에서 VS Code인가

• 가볍고 빠른 동작：저사양 머신이나 클라우드 환경에서도 쾌적하게 동작
• 풍부한 확장 기능：언어별 지원, Git 연동, 원격 개발 기능 등을 쉽게 추가할 수 있음
• 크로스 플랫폼：서로 다른 OS 간에도 동일한 사용감으로 개발 가능
• 공식 지원：Microsoft에서 Ubuntu용 공식 패키지를 제공하며, 업데이트도 용이

2. 설치 방법 비교: Snap / apt(MS 리포지토리) / 공식 DEB

2‑1. Snap(소프트웨어 센터 또는 CLI)

• Ubuntu의 표준 패키지 관리 방식으로 널리 사용되는 “Snap” 포맷으로 배포됩니다.
• Ubuntu 소프트웨어 센터에서 원클릭으로 설치 가능합니다.
• 터미널에서 sudo snap install --classic code 를 실행하면 도입할 수 있습니다。

• GUI 조작으로 쉽게 입수 가능(초보자에게 도입이 용이)。
• 자동 업데이트가 작동하므로, 안전성 및 최신 기능의 캐치업이 용이합니다。

• 오래된 방식과 다른 샌드박스 형태이기 때문에, IME나 테마와의 호환성 문제 보고가 있을 수 있습니다。
• 시작 및 응답에 약간의 오버헤드를 느낄 수도 있습니다。

2‑2. apt(Microsoft 공식 리포지토리 경유)

• Microsoft가 제공하는 APT 리포지토리를 이용해, apt로 VS Code를 관리하는 방법。
• .deb 파일을 사용해 처음에 리포지토리를 등록하고, 이후에는 일반적인 sudo apt update && sudo apt install code 로 관리할 수 있습니다。

• 표준적인 APT 관리 하에 두어 시스템과 조화된 업데이트·관리가 가능합니다。
• 일본어 입력 및 기타 기본 기능과의 호환성이 높아 안정적으로 사용할 수 있습니다。
• 업데이트 제어가 간결하고 이해하기 쉽습니다。

• 초기 설정에서 리포지토리 등록이 필요하므로, 약간 절차가 늘어납니다。
• GUI 설치에 익숙한 사람에게는 약간 장벽이 높게 느껴질 수 있습니다。

Linux Software Repository for Microsoft Products

Learn how to install Microsoft products on Linux using the p…

Technically Impossible

Microsoftレポジトリを登録し、Edge、VSCode、PowerShellを”apt install”する。 - Technically Impossible

Ubuntuでのパッケージ・マネジャーと言えば”apt”だが、そのレポジトリでVSCodeは提供されていない。Ubunt…

2‑3. 공식 DEB 파일을 사용한 단일 설치

• Microsoft 공식 사이트에서 .deb 패키지를 직접 다운로드하여 도입。
• sudo apt install ./code_*.deb 명령만으로 패키지와 의존 관계를 자동 해결하여 설치할 수 있습니다。

• 오프라인 환경이나 제한된 네트워크에서도 손쉽게 도입 가능。
• 리포지토리 등록 없이 진행할 수 있어, 최초 도입만 간단히 마치고 싶을 때 유효。

• 초기 설치 후 자동으로 업데이트를 받으려면 수동으로 리포지토리 설정이 필요합니다。
• Snap이나 공식 리포지토리 방식과 비교하면, 지속적인 운영에 약간의 수고가 필요합니다。

2‑4. 어떤 방법을 선택해야 할까? 선택 방법 흐름도

• 편리함 / GUI 조작 중시 → Snap(Ubuntu 소프트웨어 센터)
• 안정성 / 일본어 입력 및 확장성 중시 → apt(공식 리포지토리)
• 설치만 하고 싶음 / 수고를 최대한 줄이고 싶음 → 공식 DEB(단일)

3. 절차 A: 공식 DEB→apt 연동 설치 (권장)

3-1. 공식 사이트에서 DEB 파일을 가져오기

1. 브라우저에서 Visual Studio Code 공식 다운로드 페이지에 접속합니다.
2. “.deb”(Debian, Ubuntu용) 버튼을 클릭하여 파일을 다운로드합니다.

3-2. 터미널에서 설치

cd ~/다운로드
sudo apt install ./code_*.deb

• apt install에 직접 .deb 파일을 전달함으로써, 필요한 의존 패키지도 자동으로 해결됩니다.
• 이 절차를 수행하면, 동시에 Microsoft의 APT 저장소가 등록됩니다.

3-3. 설치 확인

code --version

3-4. 업데이트 방법

sudo apt update
sudo apt upgrade

3-5. 제거 방법（참고）

sudo apt remove code
sudo apt autoremove

4. 단계 B: Snap으로 설치 (GUI/CLI)

4-1. 소프트웨어 센터(GUI)에서 설치

1. ‘애플리케이션’ 메뉴에서 Ubuntu 소프트웨어를 엽니다.
2. 검색창에 “Visual Studio Code” 또는 “code”를 입력합니다.
3. 표시된 “Visual Studio Code”를 선택하고, “설치” 버튼을 클릭합니다.
4. 비밀번호를 입력한 후, 설치가 완료됩니다.

4-2. 명령줄(CLI)에서 설치

sudo snap install --classic code

• --classic 옵션은 Snap 패키지에 일반 파일 시스템 접근 권한을 부여하기 위해 필요합니다.
• 몇 분 안에 다운로드와 설치가 완료됩니다.

4-3. 설치 확인

code --version

4-4. 업데이트와 삭제

• Snap 버전은 자동 업데이트되므로, 기본적으로 수동 업데이트가 필요 없습니다.
• 삭제하려면 아래를 실행합니다.

sudo snap remove code

4-5. Snap 버전의 주의점

• 일본어 입력: 일부 환경이나 IME 설정에 따라 Snap 버전에서 입력 오류가 보고되었습니다. 발생하면 앞서 언급한 DEB→APT 방식으로 전환하면 개선되는 경우가 있습니다.
• 시작 속도: Snap의 샌드박스 구조 때문에 최초 실행 시 약간의 지연이 발생할 수 있습니다.

5. 초기 설정: 일본어화·폰트·표시 조정

5-1. 일본어화（Japanese Language Pack 도입）

1. VS Code를 실행하고, 왼쪽의 확장 기능 아이콘(사각형이 배열된 아이콘)을 클릭합니다。
2. 검색 바에 Japanese Language Pack을 입력합니다。
3. 표시된 확장 기능 “Japanese Language Pack for Visual Studio Code”를 설치합니다。
4. 설치 후, 오른쪽 아래에 표시되는 “언어를 변경하시겠습니까?” 팝업에서 [Change Language]를 클릭합니다。
5. 재시작하면, VS Code 전체가 일본어 표시가 됩니다。

5-2. 폰트 설정

1. 메뉴에서 [파일] → [기본 설정] → [설정]을 엽니다。
2. 검색 바에「font family」를 입력합니다。
3. 선호하는 폰트(예: Cascadia Code, Fira Code, Noto Sans Mono CJK JP)를 설정합니다。

5-3. 표시 조정（테마와 아이콘）

• 테마 변경: Ctrl+K → Ctrl+T로 테마 선택기를 열고, 선호하는 컬러 스킴을 선택합니다。
• 아이콘 테마: Ctrl+Shift+P → File Icon Theme으로 아이콘 세트를 변경합니다. 파일 종류를 구분하기 쉬워집니다。

5-4. 권장 추가 초기 설정

• 행 번호 표시: editor.lineNumbers를 on으로 설정합니다。
• 저장 시 자동 포맷: editor.formatOnSave를 활성화합니다。
• 자동 저장: files.autoSave를 afterDelay로 설정합니다(짧은 지연 시간으로 자동 저장)。

6. 자주 사용하는 확장 및 기본 설정 (처음 10분에 정리)

6-1. 필수급 확장 기능

1. Japanese Language Pack for Visual Studio Code

• 일본어 표시를 위한 필수 확장. 이전 섹션에서 설명되었습니다。

1. Python

• Python 개발에 필수. Lint(코드 품질 검사)와 자동 완성, 디버그 기능을 사용할 수 있게 된다。
• Jupyter 확장과 결합하면 노트북 형태로 개발도 가능。

1. C/C++

• C 언어와 C++의 코드 자동 완성, 디버그, 구문 강조 등을 제공。
• build-essential 패키지와 함께 사용한다。

1. GitLens

• Git의 히스토리와 차이를 시각적으로 표시. 팀 개발 및 히스토리 추적에 매우 유용。

1. Remote Development Pack

• SSH 대상이나 Docker 컨테이너, WSL에서의 개발을 가능하게 하는 통합 팩。
• 이후 “원격 개발” 섹션에서도 자세히 설명。

1. Prettier – Code Formatter

• 코드 포맷을 자동으로 정리해 주는 확장. JavaScript/TypeScript 및 HTML/CSS도 지원。

6-2. 처음에 설정해 두고 싶은 항목

• 저장 시 자동 정렬

  "editor.formatOnSave": true

• 탭 너비와 들여쓰기 설정

  "editor.tabSize": 4,
  "editor.insertSpaces": true

• 파일 끝의 개행

  "files.insertFinalNewline": true

• 행 번호 표시

  "editor.lineNumbers": "on"

• 불필요한 공백 자동 삭제

  "files.trimTrailingWhitespace": true

6-3. 설정 동기화 (Settings Sync) 활성화

7. 언어별 미니 환경 구축

7-1. Python 환경 구축

1. Python 본체와 가상 환경 도구 설치

   sudo apt update
   sudo apt install python3 python3-venv python3-pip

• python3-venv 은 프로젝트별 의존성을 분리하기 위한 가상 환경 기능입니다.
• pip 은 패키지 관리 도구입니다.

1. VS Code 확장 도입

• “Python” 확장을 설치합니다(Microsoft 공식).
• 필요에 따라 “Jupyter” 확장도 추가하여 노트북 형태의 실행 환경을 사용할 수 있게 합니다.

1. 가상 환경 생성 및 활성화

   python3 -m venv .venv
   source .venv/bin/activate

4. Lint/Format 설정(예: ruff와 black)

   pip install ruff black

7-2. C/C++ 환경 구축

1. 컴파일러와 필수 패키지 설치

   sudo apt update
   sudo apt install build-essential gdb

• gcc / g++ 컴파일러와 gdb 디버거가 포함됩니다.

1. VS Code 확장 도입

• “C/C++” 확장(Microsoft 공식)을 설치합니다.
• 필요에 따라 “CMake Tools”도 추가합니다.

1. 빌드 작업 설정

• 프로젝트 폴더에서 Ctrl+Shift+P → “Tasks: Configure Default Build Task”에서 g++ build active file을 선택합니다.
• 이렇게 하면 Ctrl+Shift+B로 현재 열려 있는 C/C++ 파일을 빌드할 수 있게 됩니다.

1. 디버그 설정 추가

• F5 → “C++ (GDB/LLDB)”를 선택합니다.
• .vscode/launch.json이 생성되고, 브레이크포인트와 변수 감시를 이용한 디버깅이 가능해집니다.

7-3. 확인 및 동작 테스트

print("Hello, Python on Ubuntu!")

#include <iostream>
using namespace std;

int main() {
    cout << "Hello, C++ on Ubuntu!" << endl;
    return 0;
}

8. 원격 개발: Remote SSH / Dev Containers / Codespaces

8-1. Remote SSH

1. Remote Development Pack 확장을 설치합니다(“Remote – SSH” 포함).
2. ~/.ssh/config에 연결 정보을 추가합니다. 예：

   Host myserver
       HostName 192.168.0.50
       User ubuntu
       IdentityFile ~/.ssh/id_rsa

3. Ctrl+Shift+P → “Remote-SSH: Connect to Host” → myserver를 선택합니다.

• 서버에 직접 로그인하지 않아도 VS Code에서 코드 편집·실행·디버깅이 가능합니다.
• 로컬 환경을 오염시키지 않고, 서버 의존 개발이 가능합니다.

8-2. Dev Containers

1. Docker와 Docker Compose를 Ubuntu에 설치합니다.
2. VS Code에 “Dev Containers” 확장을 설치합니다.
3. 프로젝트 폴더 바로 아래에 .devcontainer/devcontainer.json을 생성하고, 개발 환경 구성을 기술합니다. 예：

   {
       "name": "Python Dev",
       "image": "python:3.11",
       "features": {},
       "settings": {
           "terminal.integrated.shell.linux": "/bin/bash"
       }
   }

4. Ctrl+Shift+P → “Dev Containers: Reopen in Container”로 개발을 시작합니다.

• 프로젝트마다 다른 의존 패키지와 툴체인을 완전히 분리할 수 있습니다.
• 팀 전체가 동일한 환경에서 개발할 수 있어 동작 재현성이 높습니다.

8-3. GitHub Codespaces

1. GitHub 리포지토리에 접근하고, “Code” → “Codespaces” → “New codespace”를 클릭합니다.
2. 수십 초 안에 클라우드 상에 개발 환경이 구축되어, 브라우저 내에서 VS Code를 사용할 수 있습니다.
3. 필요에 따라 로컬 VS Code에서 연결하는 것도 가능합니다.

• 저사양 PC나 모바일에서도 본격적인 개발이 가능합니다.
• 네트워크 환경만 있으면 어디서든 동일한 환경으로 작업할 수 있습니다.

9. 자주 발생하는 문제와 대처

9-1. 일본어 입력이 안 되거나 변환이 불안정

• Snap 버전 VS Code에서 IME(일본어 입력 시스템)와의 호환성 문제로 오류가 발생할 수 있습니다。
• 샌드박스 환경 내에서 입력 메서드가 제대로 작동하지 않는 경우。

• Snap 버전을 제거하고 공식 DEB 버전(APT 연동)으로 재설치합니다。
• 필요에 따라 fcitx와 ibus를 재설정합니다。

9-2. 시작이 느리거나 동작이 무거움

• Snap 버전의 샌드박스 초기화 처리나 확장 기능 로드에 시간이 오래 걸릴 가능성。
• 불필요한 확장이 대량으로 활성화되어 있음。

• 시작 옵션 code --disable-extensions 로 확장을 비활성화하고 실행하여 문제 확장을 식별하고 삭제합니다。
• Snap 버전을 DEB 버전으로 전환하면 개선되는 경우가 많습니다。

9-3. 특정 확장이 동작하지 않음

• Ubuntu 버전이나 라이브러리 의존 관계가 부족함。
• 컨테이너나 원격 환경에서 권한 부족이 발생함。

• 터미널에서 sudo apt install 명령을 사용해 필요한 의존 패키지를 설치합니다。
• 권한 오류인 경우, 확장이 필요로 하는 경로의 접근 권한을 확인합니다。

9-4. Wayland 환경에서 표시 및 입력이 불안정

• VS Code는 XWayland를 통해 동작하는 경우가 많아 Wayland 네이티브 호환성이 아직 완전하지 않음。

• 로그인 화면에서 세션을 Xorg로 전환하여 실행합니다。
• 또는 시작 시 다음과 같이 지정：

  code --ozone-platform=x11

9-5. 완전히 제거하고 싶음

• DEB 버전：

  sudo apt remove code
  sudo apt autoremove
  rm -rf ~/.config/Code

• Snap 버전：

  sudo snap remove code
  rm -rf ~/.config/Code

10. 보안 및 업데이트 정책

10-1. 설치 방식별 업데이트 동작

1. APT(공식 리포지토리) 버전

• Microsoft 공식 APT 리포지토리가 등록되므로, sudo apt update && sudo apt upgrade 로 OS 업데이트와 동시에 최신 버전이 반영됩니다.
• 업데이트 내용에는 보안 수정 및 새로운 기능이 포함되어, 안정성과 최신성의 균형이 좋습니다.

1. Snap 버전

• Snapd가 자동 업데이트를 수행하여 기본적으로 사용자의 조작 없이 최신화됩니다.
• 다만, 자동 업데이트 시점은 Snapd의 스케줄에 의존하므로 바로 반영되지 않을 수도 있습니다.

1. DEB 단일 설치 버전(리포지토리 미등록)

• 자동 업데이트되지 않습니다.
• 새 버전이 필요할 경우 공식 사이트에서 수동으로 다운로드 및 재설치해야 합니다.

10-2. 보안상의 주의점

• 신뢰할 수 있는 소스에서 입수하기
• 반드시 공식 사이트 또는 Microsoft 공식 리포지토리에서 다운로드하십시오.
• 비공식 PPA나 제3자 배포 패키지는 변조 및 악성코드 포함 위험이 있습니다.
• 확장 기능 선택
• 배포원 및 리뷰 평점을 확인하고, 알 수 없는 배포원의 확장은 피하십시오.
• 오랫동안 업데이트되지 않은 확장은 취약점이 방치될 가능성이 있습니다.
• 권한 관리
• Remote SSH나 Dev Containers 등 원격 기능을 사용할 때는 연결 대상의 권한 및 공개키 관리를 엄격히 수행하십시오.
• Docker 환경을 이용할 경우 불필요한 포트 공개나 root 권한 컨테이너의 지속 사용을 피하십시오.

10-3. 업데이트 시점의 기준

• 안정적인 운영이 필요한 경우: LTS 버전 Ubuntu의 업데이트 일정에 맞추어, 몇 주마다 한 번씩 모아서 업데이트합니다.
• 새 기능을 적극적으로 사용하고 싶은 경우: 주 1회 정도 업데이트 확인으로 최신 빌드를 적용합니다.
• Snap 버전 사용 시: 자동 업데이트에 맡기되, 문제가 발생하면 수동으로 롤백(sudo snap revert code)도 고려합니다.

11. 요약: 가장 빠르게 “사용 가능한” Ubuntu×VS Code 환경을

11-1. 가장 빠른 구축 단계

1. 설치

• 안정성 및 업데이트 용이성을 중시한다면 공식 DEB → APT 연동을 선택합니다.
• 가볍게 시도하고 싶다면 Snap 버전도 OK(단, 일본어 입력 호환성에 주의).

1. 초기 설정

• Japanese Language Pack을 도입해 일본어화합니다.
• 폰트와 테마를 취향에 맞게 조정합니다.
• 저장 시 자동 포맷 및 행 번호 표시 등 최소한의 에디터 설정을 활성화합니다.

1. 필수 확장 도입

• Python, C/C++, GitLens, Remote Development Pack, Prettier 등.
• Settings Sync를 활성화하여 여러 장치에서도 동일한 환경을 재현합니다.

1. 개발 언어 설정

• Python: python3-venv와 확장을 설치하고, Lint/Format 설정을 정비합니다.
• C/C++: build-essential와 확장을 설치하고, 빌드·디버그 설정을 만듭니다.

1. 원격 개발 환경 구축

• Remote SSH를 사용해 서버상의 코드를 직접 편집합니다.
• Dev Containers로 프로젝트별로 환경을 분리합니다.
• 필요에 따라 GitHub Codespaces로 클라우드 개발을 합니다.

1. 보안 및 업데이트 관리

• 공식 배포처만 이용하고, 확장은 신뢰할 수 있는 것에 한정합니다.
• 정기적으로 apt upgrade 또는 Snap 업데이트 확인을 수행합니다.

11-2. 본 기사 활용법

• Ubuntu를 처음 사용하는 분은, 본 기사 순서대로 설정하면 1시간 이내에 실용 개발 환경이 갖춰집니다.
• 이미 다른 에디터를 사용하고 있는 분은, VS Code의 강력한 확장 기능과 원격 개발 기능을 활용해 작업 효율을 크게 향상시킬 수 있습니다.
• 문제가 발생해도 9장의 대처법을 보면 즉시 복구가 가능합니다.

FAQ(자주 묻는 질문 모음)