Linux に Visual Studio Code をインストールする
Visual Studio Code は、公式の Debian、RPM、Snap パッケージを通じて Linux で利用できます。コミュニティがメンテナンスしているパッケージは、Arch Linux と Nix でも利用可能です。
Linux への VS Code のインストール
お使いの Linux ディストリビューションに合ったパッケージ方法を選択してください。
Debian および Ubuntu ベースのディストリビューション
-
.deb パッケージをダウンロードします。
-
グラフィカルなソフトウェアセンターでパッケージをインストールするか、コマンドラインからインストールします。
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 リポジトリを手動でインストールするには
-
署名キーをインストールします。
sudo apt install wget gpg && wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft.gpg -
/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 -
パッケージキャッシュを更新し、パッケージをインストールします。
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 パッケージを提供しています。
-
キーと 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 -
パッケージキャッシュを更新し、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 パッケージとして公式に配布されています。
このコマンドで 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 ベースのシステムでも機能します。
-
キーと 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 -
パッケージキャッシュを更新し、パッケージをインストールします。
sudo zypper install code
Arch Linux AUR パッケージ
VS Code の Arch User Repository パッケージはコミュニティがメンテナンスしています。
インストールの詳細については、AUR パッケージのインストールに関する Arch Linux wiki 記事を参照してください。
Nix パッケージ
nixpkgs リポジトリにあるVS Code Nix パッケージはコミュニティがメンテナンスしています。
Nix を使用して VS Code をインストールするには
-
config.nixでallowUnfreeオプションを true に設定します。 -
このコマンドを実行します。
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 ) 設定でタイトルバーを設定します。
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、Node.js、TypeScript、言語ランタイム、コマンドラインツールを含む追加コンポーネントをインストールします。
- テーマ、フォーマッター、デバッガー、言語サポートを追加するために、Visual Studio Marketplace から拡張機能をインストールします。
- VS Code で AI 機能を使用するためにGitHub Copilot を設定します。
- ユーザーインターフェイスと主要機能のハンズオンツアーとして、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 設定に追加してください。他の実行中のアプリケーションもファイルハンドルを消費する可能性があるため、他のアプリケーションを閉じることも役立つ場合があります。
現在の制限は、このコマンドを実行して表示できます。
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 設定を使用して、特定のワークスペースディレクトリを 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"
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 Level を Off に設定します。このオペレーティングシステムの設定は、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 を 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
