Linux に Visual Studio Code をインストールする

Visual Studio Code は、公式の Debian、RPM、Snap パッケージを通じて Linux で利用できます。コミュニティがメンテナンスしているパッケージは、Arch Linux と Nix でも利用可能です。

Linux への VS Code のインストール

お使いの Linux ディストリビューションに合ったパッケージ方法を選択してください。

Debian および Ubuntu ベースのディストリビューション
  1. .deb パッケージをダウンロードします。

  2. グラフィカルなソフトウェアセンターでパッケージをインストールするか、コマンドラインからインストールします。

    sudo apt install ./<file>.deb
    
    # On older Linux distributions, run these commands instead:
    # sudo dpkg -i <file>.deb
    # sudo apt-get install -f # Install dependencies
    
    注意

    その他のバイナリは、VS Code ダウンロードページで入手できます。

.deb パッケージは apt リポジトリと署名キーのインストールを促し、これによりシステムパッケージマネージャーを介した自動更新が可能になります。

非対話型インストールの場合、.deb パッケージをインストールする前にこのコマンドを実行して、apt リポジトリと署名キーを自動的にインストールします。

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

apt リポジトリを手動でインストールするには

  1. 署名キーをインストールします。

    sudo apt install wget gpg &&
    wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/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 update &&
    sudo apt install code # or code-insiders
    
注意

手動署名プロセスと公開システムのため、Debian リポジトリは最大3時間遅れる可能性があり、VS Code の最新バージョンをすぐに含んでいない場合があります。

RHEL、Fedora、および CentOS ベースのディストリビューション

Microsoft は、RHEL、Fedora、および CentOS ベースのディストリビューション向けに、yum リポジトリで安定版の 64 ビット VS Code パッケージを提供しています。

  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. パッケージキャッシュを更新し、Fedora 22 以降では dnf を使用してパッケージをインストールします。

    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

このコマンドで Snap パッケージをインストールします。

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

インストール後、Snap デーモンはバックグラウンドで VS Code を自動的に更新します。VS Code は、新しい更新が利用可能になるたびに、製品内更新通知を表示します。

注意

お使いの Linux ディストリビューションで snap が利用できない場合は、snapd のインストールガイドを確認してください。

Snap については、公式の Snap ドキュメントで詳細を確認してください。

openSUSE および SLE ベースのディストリビューション

RHEL、Fedora、および CentOS パネルの 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 User Repository パッケージはコミュニティがメンテナンスしています。

インストールの詳細については、AUR パッケージのインストールに関する Arch Linux wiki 記事を参照してください。

Nix パッケージ

nixpkgs リポジトリにあるVS Code Nix パッケージはコミュニティがメンテナンスしています。

Nix を使用して VS Code をインストールするには

  1. config.nixallowUnfree オプションを true に設定します。

  2. このコマンドを実行します。

    nix-env -i vscode
    
手動 RPM パッケージ

リポジトリからのインストールが利用できない場合は、VS Code .rpm パッケージを手動でダウンロードしてインストールします。リポジトリがインストールされていない限り、自動更新は機能しません。

ダウンロードした .rpm パッケージを、例えば dnf を使用して、お使いのパッケージマネージャーでインストールします。

sudo dnf install <file>.rpm
注意

その他のバイナリは、VS Code ダウンロードページで入手できます。

アップデート

VS Code は毎週リリースされます。VS Code リポジトリが正しくインストールされていれば、システムパッケージマネージャーはシステム上の他のパッケージと同様に自動更新を処理します。

注意

Snap パッケージの場合、更新は自動的にバックグラウンドで実行されます。

VS Code を既定のテキストエディターとして設定する

xdg-open

xdg-open で使用されるテキストファイル (text/plain) の既定のテキストエディターとして VS Code を設定します。

xdg-mime default code.desktop text/plain

Debian alternatives システム

Debian ベースのディストリビューションは、MIME タイプを気にせずに、Debian alternatives システムを介して既定の editor を設定することをサポートしています。このコマンドを使用して VS Code を既定のエディターとして設定します。

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

VS Code が Snap パッケージでインストールされた場合は、代わりにこのコマンドを使用します。

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

VS Code が既定の editor の代替として表示されない場合は、登録します。

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

カスタムタイトルバーを使用する

カスタムタイトルバーは、キーボードナビゲーションやスクリーンリーダーによるテーマサポートとアクセシビリティの向上を提供します。デスクトップ環境やウィンドウマネージャーが異なるため、これらの利点が Linux に常にうまく反映されるとは限りません。このため、Linux ではカスタムタイトルバーは既定で有効になっていません。

スクリーンリーダーを使用している際のアクセシビリティ向上のため、アクセシビリティモードで実行している場合はカスタムタイトルバーを有効にしてください。

Window: Title Bar Style ( window.titleBarStyle Open in VS Code Open in VS Code Insiders ) 設定でタイトルバーを設定します。

  • custom: カスタムタイトルバーを使用します。
  • native: オペレーティングシステムのタイトルバーを使用します。

WSL を使用して Linux で開発する

VS Code を使用した Linux 開発のもう1つの選択肢は、Windows Subsystem for Linux (WSL) を備えた Windows マシンを使用することです。

WSL を使用すると、Windows マシンでローカルに作業しながら、Windows 上で Linux ディストリビューションをインストールして実行し、Linux 上でソースコードを開発およびテストできます。WSL は、Microsoft Store から Ubuntu、Debian、SUSE、Alpine などの Linux ディストリビューションをサポートしています。

WSL 拡張機能と組み合わせると、VS Code は WSL 上の Linux ディストリビューションのコンテキストで実行しながら、編集およびデバッグのサポートを提供します。

詳細については、WSL での開発ドキュメントを参照するか、WSL での作業入門チュートリアルを試してください。

インストール後

VS Code のインストール後、開発ワークフローのセットアップを完了します。

よくある質問

git パッケージがインストールされていません。

このエラーは、パッケージマネージャーのリストが古い場合にインストール中に表示されることがあります。パッケージマネージャーを更新して、再度インストールしてください。

# For .deb
sudo apt-get update

# For .rpm on Fedora 21 and earlier
sudo yum check-update

# For .rpm on Fedora 22 and later
sudo dnf check-update
他のリポジトリからの VS Code パッケージとの競合

Pop!_OS など、一部のディストリビューションは独自の code パッケージを提供しています。公式の VS Code リポジトリが使用されるようにするには、/etc/apt/preferences.d/code という名前のファイルを以下の内容で作成します。

Package: code
Pin: origin "packages.microsoft.com"
Pin-Priority: 9999
Debian とファイルのゴミ箱への移動

Debian で VS Code エクスプローラーからファイルを削除できない場合、VS Code が使用するゴミ箱の実装が不足している可能性があります。

不足しているパッケージをインストールするには、このコマンドを実行します。

sudo apt-get install gvfs libglib2.0-bin
「Visual Studio Code は、この大規模なワークスペースでのファイル変更を監視できません」(エラー ENOSPC)

この通知は、VS Code のファイルウォッチャーがファイルハンドルを使い果たしていることを示します。これは、多数のファイルを含むワークスペースを開く際によく発生します。プラットフォームの制限を調整する前に、Python の .venv のような大きなフォルダーを files.watcherExclude Open in VS Code Open in VS Code Insiders 設定に追加してください。他の実行中のアプリケーションもファイルハンドルを消費する可能性があるため、他のアプリケーションを閉じることも役立つ場合があります。

現在の制限は、このコマンドを実行して表示できます。

cat /proc/sys/fs/inotify/max_user_watches

/etc/sysctl.conf を編集し、ファイルの末尾にこの行を追加して制限を最大まで引き上げます。Arch Linux および Ubuntu 24.10 以降では、/etc/sysctl.d/*.conf 内のファイルを使用します。

fs.inotify.max_user_watches=524288

新しい値を読み込みます。

sudo sysctl --system

各ファイル監視は1,080バイトを消費します。すべての 524,288 個の監視が消費された場合、上限は約 540 MiB です。メモリ制約のある環境では、より低い値を選択してください。

もう1つのオプションは、 files.watcherExclude Open in VS Code Open in VS Code Insiders 設定を使用して、特定のワークスペースディレクトリを VS Code ファイルウォッチャーから除外することです。既定の files.watcherExclude Open in VS Code Open in VS Code Insiders 値は、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 Open in VS Code Open in VS Code Insiders を設定します。

"editor.fontFamily": "Droid Sans Mono, Droid Sans Fallback"
Ubuntu で code コマンドを実行してもウィンドウが前面に表示されない

Ubuntu で現在のディレクトリに VS Code がすでに開いている状態で code . を実行しても、VS Code が前面に表示されません。これはオペレーティングシステムの動作であり、ccsm で変更できます。

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

# Run
ccsm

General > General Options > Focus & Raise Behavior で、Focus Prevention LevelOff に設定します。このオペレーティングシステムの設定は、VS Code だけでなく、すべてのアプリケーションに適用されます。

「/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 Open in VS Code Open in VS Code Insiders 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
© . This site is unofficial and not affiliated with Microsoft.