LinuxにVSCodeをインストールする方法について

採用はこちら

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
FedoraRPM、DNF
RHELRPM、DNF
CentOS系RPM、DNF
openSUSERPM、Zypper
Arch LinuxAURなど
Nix・NixOSnixpkgs
Snap対応LinuxSnap

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をインストールする方法についてでした。

最後までお読みいただき、ありがとうございました。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
目次