Visual Studio Code(VS Code)は、Microsoftが提供している無料のコードエディターです。
WindowsやmacOSだけでなくLinuxにも対応しており、UbuntuやDebian、Fedora、RHEL、openSUSEなど、さまざまなLinuxディストリビューションで利用できます。
LinuxにVS Codeをインストールする方法は、利用しているディストリビューションによって異なります。
UbuntuやDebianでは.debパッケージやAPT、FedoraやRHELではRPMやDNF、Snap対応環境ではSnapを利用する方法が代表的です。
この記事では、LinuxにVS Codeをインストールする方法をディストリビューション別に詳しく解説します。
LinuxにVSCodeをインストールする主な方法
Linux版VS Codeには複数のインストール方法があります。
代表的な方法は次のとおりです。
| Linux環境 | 主なインストール方法 |
|---|---|
| Ubuntu | .deb、APT、Snap |
| Debian | .deb、APT、Snap |
| Linux Mint | .deb、APT |
| Fedora | RPM、DNF |
| RHEL | RPM、DNF |
| CentOS系 | RPM、DNF |
| openSUSE | RPM、Zypper |
| Arch Linux | AURなど |
| Nix・NixOS | nixpkgs |
| Snap対応Linux | Snap |
Microsoft公式版のVS Codeを利用したい場合は、基本的にMicrosoftが提供している.deb、.rpm、Snap、または公式パッケージリポジトリを利用すると分かりやすいでしょう。
Ubuntu・DebianにVSCodeをインストールする方法
UbuntuやDebianなどのDebian系Linuxでは、.debパッケージをダウンロードしてインストールする方法が簡単です。
Linux Mintなど、DebianやUbuntuをベースにしたディストリビューションでも同様の方法を利用できる場合があります。
公式のdebファイルをダウンロードする
まず、Visual Studio Codeの公式サイトからLinux向けの.debパッケージをダウンロードします。
一般的なIntel・AMD製64bit CPUを搭載したPCでは、通常は64bit版を選択します。
ダウンロードしたファイルは、たとえば次のような名前になります。
code_1.xx.x-xxxxxxxxxx_amd64.deb
debファイルをAPTでインストールする
ターミナルを開き、ダウンロードフォルダへ移動します。
cd ~/Downloads
続いて、次のコマンドを実行します。
sudo apt install ./code_*.deb
特定のファイル名を指定する場合は、次のように実行しても構いません。
sudo apt install ./code_1.xx.x-xxxxxxxxxx_amd64.deb
./を付けることで、現在のディレクトリに存在するローカルパッケージをAPTでインストールできます。
公式.debパッケージをインストールすると、MicrosoftのAPTリポジトリと署名鍵を追加するか確認される場合があります。
追加を許可しておけば、以降は通常のAPTによるアップデート対象としてVS Codeを管理できます。
dpkgを使ってインストールする方法
古いDebian系環境などでは、dpkgを利用することもできます。
sudo dpkg -i code_*.deb
依存関係に問題が発生した場合は、次のコマンドを実行します。
sudo apt-get install -f
ただし、現在のUbuntuやDebianでは、基本的には次の方法の方が簡単です。
sudo apt install ./code_*.deb
APTを利用すれば依存関係もまとめて処理できます。
APTリポジトリからVSCodeをインストールする方法
複数台のLinux PCへVS Codeを導入する場合や、セットアップを自動化したい場合は、MicrosoftのAPTリポジトリを直接登録する方法も便利です。
必要なパッケージをインストールする
まず、署名鍵を取得するために必要なパッケージをインストールします。
sudo apt install wget gpg
Microsoftの署名鍵を登録する
次のコマンドを実行します。
wget -qO- https://packages.microsoft.com/keys/microsoft.asc \
| sudo gpg --dearmor -o /usr/share/keyrings/microsoft.gpg
これでMicrosoftパッケージの署名を確認するための鍵が登録されます。
VSCodeのAPTリポジトリを登録する
次に、次のファイルを作成します。
/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
VS Codeをインストールします。
sudo apt install code
これでAPTからVS Codeをインストールできます。
FedoraにVSCodeをインストールする方法
Fedoraでは、Microsoftが提供しているRPMリポジトリを利用できます。
MicrosoftのGPGキーを登録する
次のコマンドを実行します。
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
VSCodeのRPMリポジトリを登録する
次のコマンドでリポジトリを作成します。
echo -e "[code]
name=Visual Studio Code
baseurl=https://packages.microsoft.com/yumrepos/vscode
enabled=1
autorefresh=1
type=rpm-md
gpgcheck=1
gpgkey=https://packages.microsoft.com/keys/microsoft.asc" |
sudo tee /etc/yum.repos.d/vscode.repo > /dev/null
DNFでVSCodeをインストールする
リポジトリを登録したら、次のコマンドを実行します。
dnf check-update
続いてVS Codeをインストールします。
sudo dnf install code
なお、dnf check-updateは更新可能なパッケージが存在すると終了コード100を返すことがあります。
通常の手動操作では大きな問題になりませんが、シェルスクリプトなどで利用する場合は注意が必要です。
RHEL・CentOS系LinuxにVSCodeをインストールする方法
RHELやCentOS系Linuxでも、基本的にはFedoraと同じMicrosoft公式RPMリポジトリを利用できます。
リポジトリを登録した後、次のコマンドを実行します。
sudo dnf install code
古い環境でdnfではなくyumを利用している場合は、次のようにします。
sudo yum install code
RPMファイルを直接インストールする方法
FedoraやRHEL系Linuxでは、Microsoft公式サイトから.rpmファイルをダウンロードして直接インストールすることもできます。
たとえば、ダウンロードしたRPMファイルがあるディレクトリで次のように実行します。
sudo dnf install ./code-*.rpm
この方法でもVS Codeを利用できます。
ただし、RPMファイルを手動でインストールしただけでは、Microsoftのリポジトリが登録されていない場合があります。
その場合は、自動的に最新バージョンへ更新されません。
継続的にVS Codeを利用する場合は、公式RPMリポジトリを登録しておくと管理しやすくなります。
openSUSEにVSCodeをインストールする方法
openSUSEやSUSE Linux EnterpriseでもMicrosoftのRPMリポジトリを利用できます。
MicrosoftのGPGキーを登録する
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
VSCodeのリポジトリを登録する
次のコマンドでVS Codeのリポジトリを作成します。
echo -e "[code]
name=Visual Studio Code
baseurl=https://packages.microsoft.com/yumrepos/vscode
enabled=1
autorefresh=1
type=rpm-md
gpgcheck=1
gpgkey=https://packages.microsoft.com/keys/microsoft.asc" |
sudo tee /etc/zypp/repos.d/vscode.repo > /dev/null
ZypperでVSCodeをインストールする
sudo zypper install code
これでopenSUSEでもVS Codeを利用できます。
SnapでVSCodeをインストールする方法
Snapが利用できるLinuxでは、非常に簡単にVS Codeをインストールできます。
Snap版VSCodeをインストールする
次のコマンドを実行します。
sudo snap install --classic code
インストールが完了したら、次のコマンドで起動できます。
code
Snap版のVS Codeは公式に提供されており、Snapの仕組みによって更新も管理されます。
Snap版VSCodeのメリット
Snap版の最大のメリットは、インストールが簡単なことです。
基本的には次のコマンドだけで導入できます。
sudo snap install --classic code
MicrosoftのAPTリポジトリやRPMリポジトリを手動で設定する必要がありません。
Snap版VSCodeの注意点
SnapはAPTやDNFとは別のパッケージ管理システムです。
そのため、Ubuntuで、
sudo apt upgrade
を実行してもSnap版VS Codeの更新処理とは直接関係ありません。
通常、SnapパッケージはSnap側の仕組みによって自動更新されます。
手動で更新する場合は次のようにします。
sudo snap refresh code
Arch LinuxにVSCodeをインストールする方法
Arch Linuxでは、Microsoft公式のAPTやRPMリポジトリとは異なり、AURなどを利用する方法があります。
AURにあるVS Code関連パッケージはコミュニティによって管理されています。
Microsoft公式リポジトリそのものではない点には注意しましょう。
yayを使う場合のインストール例
AURヘルパーとしてyayを利用している場合は、たとえば次のようにインストールできます。
yay -S visual-studio-code-bin
これはArch Linuxで利用されている一例であり、Microsoft公式がyayを推奨しているという意味ではありません。
また、Arch LinuxではCode – OSSなどのパッケージも利用できます。
Microsoft公式のVisual Studio Codeとは配布物や一部の仕様が異なる場合があるため、パッケージ名を確認してからインストールしましょう。
Nix・NixOSにVSCodeをインストールする方法
Nix環境でもVS Codeを利用できます。
VS Codeにはプロプライエタリ要素が含まれるため、NixではallowUnfreeの設定が必要になる場合があります。
MicrosoftのVS Code公式ドキュメントでは、次のようなコマンドが紹介されています。
nix-env -i vscode
ただし、最近のNixやNixOSでは、Flakesやnix profile、NixOSの宣言的なパッケージ設定を利用している環境もあります。
そのため、実際には現在利用しているNixの構成方法に合わせてVS Codeを追加するのが適切です。
VSCodeがインストールされたか確認する方法
VS Codeのインストールが完了したら、ターミナルから正常に利用できるか確認します。
VSCodeのバージョンを確認する
次のコマンドを実行します。
code --version
正常にインストールされていれば、VS Codeのバージョン番号などが表示されます。
codeコマンドの場所を確認する
次のコマンドも利用できます。
command -v code
正常にPATHへ登録されていれば、たとえば次のような結果が表示されます。
/usr/bin/code
環境によっては、次のコマンドでも確認できます。
which code
LinuxでVSCodeを起動する方法
VS Codeをインストールすると、アプリケーションメニューだけでなくターミナルから起動できます。
VSCodeだけを起動する
code
VS Codeのウィンドウが起動します。
現在のフォルダをVSCodeで開く
開発時に非常によく利用するのが次のコマンドです。
code .
.は現在のディレクトリを意味します。
たとえば、プロジェクトフォルダへ移動してから、
cd ~/projects/my-app
code .
と実行すると、my-appフォルダをVS Codeで開けます。
特定のファイルをVSCodeで開く
特定のファイルを指定することもできます。
code main.py
これでmain.pyがVS Codeで開きます。
特定のフォルダを開く
code ~/projects/sample
このようにフォルダのパスを直接指定することもできます。
VSCodeをアップデートする方法
VS Codeの更新方法は、インストール方法によって異なります。
Ubuntu・Debianで更新する
APTリポジトリが登録されている場合は、通常のシステムアップデートでVS Codeも更新できます。
sudo apt update
sudo apt upgrade
VS Codeだけを更新したい場合は、次のように実行できます。
sudo apt update
sudo apt install --only-upgrade code
Fedora・RHELで更新する
sudo dnf upgrade code
環境によってはシステム全体を、
sudo dnf upgrade
で更新することもできます。
Snap版を更新する
Snap版は通常、自動的に更新されます。
手動で更新する場合は次のコマンドを利用します。
sudo snap refresh code
VSCodeをアンインストールする方法
VS Codeが不要になった場合は、インストールに使用したパッケージ管理システムから削除します。
Ubuntu・Debianから削除する
sudo apt remove code
APT上のパッケージ設定も削除したい場合は、
sudo apt purge code
を利用できます。
Fedora・RHELから削除する
sudo dnf remove code
Snap版を削除する
sudo snap remove code
VSCodeの設定や拡張機能も削除する方法
パッケージをアンインストールしても、ホームディレクトリにVS Codeのユーザーデータが残る場合があります。
代表的な保存場所は次のとおりです。
~/.config/Code
~/.vscode-shared
~/.vscode
完全に初期状態へ戻す場合は、必要に応じてこれらを削除します。
rm -rf ~/.config/Code
rm -rf ~/.vscode-shared
rm -rf ~/.vscode
ただし、この操作を行うとVS Codeの設定や拡張機能などが失われる可能性があります。
必要なデータをバックアップしたうえで実行してください。
VSCodeとCode – OSSの違い
Linuxでは、「Visual Studio Code」と「Code – OSS」という似たソフトウェアを見かけることがあります。
両者は完全に同じ配布物ではありません。
Visual Studio Codeとは
Visual Studio Codeは、Microsoftがビルドして公式に配布しているVS Codeです。
Microsoftの公式サイトや公式リポジトリから入手できます。
Code – OSSとは
Code – OSSは、Visual Studio Codeのオープンソース部分をベースとしてビルドされたものです。
Linuxディストリビューションによっては、独自のCode – OSSパッケージを提供している場合があります。
そのため、Microsoft公式のVisual Studio Codeを利用したい場合は、パッケージ名や配布元を確認することが重要です。
VSCode InsidersをLinuxにインストールする方法
VS Codeには通常版のほかに「Visual Studio Code Insiders」もあります。
Insiders版では、正式版より早く新機能を試すことができます。
Ubuntu・Debianの場合
Microsoftリポジトリを登録している場合は、次のようにインストールできます。
sudo apt install code-insiders
Fedora・RHELの場合
sudo dnf install code-insiders
Snapの場合
sudo snap install --classic code-insiders
Insiders版は最新機能を試したい開発者には便利ですが、安定性を重視する場合は通常版のcodeを利用する方が無難です。
ARM版LinuxでVSCodeをインストールするときの注意点
Linux PCがARM CPUを搭載している場合は、CPUアーキテクチャに合ったパッケージを選択する必要があります。
CPUアーキテクチャを確認する
次のコマンドを実行します。
uname -m
一般的な結果としては、次のようなものがあります。
x86_64
これは一般的な64bit Intel・AMD環境です。
aarch64
これは64bit ARM環境です。
MicrosoftのDebian向けVS Codeリポジトリでは、amd64、arm64、armhfなどのアーキテクチャが用意されています。
CPUに対応していないパッケージをダウンロードするとインストールできないため注意してください。
Linux版VSCodeのシステム要件を確認する
古いLinuxを使用している場合は、VS Codeのシステム要件にも注意が必要です。
現在のVS Codeでは、主なLinux要件として、
GLIBC 2.28以降
GLIBCXX 3.4.25以降
などが求められます。
そのため、非常に古いUbuntu、Debian、CentOSなどでは、最新版VS Codeが正常に動作しない場合があります。
古いPCへVS Codeをインストールする場合は、OSのバージョンだけでなくGLIBCなどのライブラリ要件も確認しておくことが重要です。
LinuxでVSCodeをインストールできない場合の対処法
VS Codeのインストールや起動時には、いくつかのトラブルが発生することがあります。
「code: command not found」と表示される
次のようなエラーが表示される場合があります。
code: command not found
まず、VS Codeがインストールされているか確認します。
Ubuntu・Debianでは、
dpkg -l | grep code
FedoraやRHELでは、
rpm -qa | grep code
などを利用できます。
さらに、
command -v code
でcodeコマンドがPATHに登録されているか確認します。
依存関係のエラーが発生する
Debian系Linuxで.debパッケージのインストール時に依存関係エラーが発生した場合は、
sudo apt --fix-broken install
を実行します。
その後、再度、
sudo apt install ./code_*.deb
を実行してみましょう。
CPUアーキテクチャが一致しているか確認する
ARM PCへAMD64版をインストールするなど、CPUアーキテクチャが異なる場合もインストールできません。
次のコマンドで確認できます。
uname -m
ダウンロードしたVS Codeのパッケージが、自分のCPUに対応しているか確認してください。
Ubuntuではどのインストール方法がおすすめか
一般的なUbuntuデスクトップでMicrosoft公式版のVS Codeを利用する場合は、公式.debパッケージを利用する方法が分かりやすい選択肢です。
公式サイトから.debファイルをダウンロードし、
sudo apt install ./code_*.deb
と実行すれば比較的簡単に導入できます。
リポジトリ追加を許可しておけば、その後のVS CodeもAPTから管理できます。
一方、できるだけ簡単にインストールしたい場合は、
sudo snap install --classic code
という方法もあります。
複数PCへの導入やセットアップの自動化を行う場合は、Microsoft公式APTリポジトリを登録して、
sudo apt install code
で管理すると便利です。
LinuxへのVSCodeインストール方法まとめ
LinuxにVS Codeをインストールする方法は、使用しているディストリビューションによって異なります。
Ubuntu、Debian、Linux Mintなどでは.debパッケージやAPT、FedoraやRHELではRPMやDNF、openSUSEではZypper、Snap対応LinuxではSnapを利用できます。
UbuntuやDebianを使用している場合は、Microsoft公式サイトから.debファイルをダウンロードし、
sudo apt install ./code_*.deb
でインストールする方法が比較的簡単です。
FedoraやRHELではMicrosoftのRPMリポジトリを登録して、
sudo dnf install code
とすると管理しやすくなります。
Snap対応環境であれば、
sudo snap install --classic code
という方法もあります。
インストール後は、
code --version
で正常にインストールされているか確認できます。
さらに、LinuxでVS Codeを使う場合は、
code .
というコマンドを覚えておくと便利です。
現在作業しているディレクトリをそのままVS Codeで開けるため、ターミナルを中心に開発する場合に特によく使用します。
以上、LinuxにVSCodeをインストールする方法についてでした。
最後までお読みいただき、ありがとうございました。










