VSCode（Visual Studio Code）は、インターネットに接続できない環境でも日本語化できます。
オフライン環境で日本語化する場合は、インターネットに接続できる別のPCで「Japanese Language Pack for Visual Studio Code」のVSIXファイルを用意し、USBメモリなどを使ってオフラインPCへ移動してインストールします。
VSCodeでは英語のユーザーインターフェースが標準で用意されており、日本語などの表示言語はLanguage Packという拡張機能によって追加する仕組みになっています。
日本語化に使用する公式の拡張機能IDは、次のとおりです。
MS-CEINTL.vscode-language-pack-ja
日本語のロケールコードは、次のようになります。
ja
完全なオフライン環境ではVSCodeからVisual Studio Marketplaceへアクセスできないため、VSIXファイルをあらかじめ準備しておくことが重要です。
VSCodeをオフラインで日本語化する基本的な流れ
オフラインでVSCodeを日本語化する場合は、基本的に次の流れで作業します。
インターネット接続済みPC
↓
Japanese Language PackのVSIXを取得
↓
USBメモリなどへ保存
↓
オフラインPCへコピー
↓
VSCodeでVSIXをインストール
↓
表示言語を日本語に変更
↓
VSCodeを再起動
一度VSIXファイルを用意しておけば、複数のオフラインPCに同じLanguage Packをインストールすることも可能です。
オンラインPCでJapanese Language Packを準備する
Japanese Language Packを検索する
まずは、インターネットに接続できるPCでVSCodeを起動します。
左側にある「Extensions」のアイコンをクリックしてください。
WindowsやLinuxでは、次のショートカットでもExtensions画面を開けます。
Ctrl + Shift + X
検索欄へ、次のように入力します。
Japanese Language Pack
または、拡張機能IDを直接入力しても構いません。
MS-CEINTL.vscode-language-pack-ja
検索結果から「Japanese Language Pack for Visual Studio Code」を確認します。
似た名前の拡張機能と間違えないように、拡張機能IDも確認しておくと安心です。
VSIXファイルをダウンロードする
Japanese Language Packが見つかったら、拡張機能の項目を右クリックします。
メニューの中から、次の項目を選択します。
Download VSIX
VSCodeのバージョンや画面構成によっては、特定バージョンを取得するために次の項目を利用できる場合もあります。
Download Specific Version VSIX
ダウンロードすると、次のようなVSIXファイルが保存されます。
MS-CEINTL.vscode-language-pack-ja-x.x.x.vsix
x.x.xの部分には、Language Packのバージョン番号が入ります。
VSIXファイルをUSBメモリなどへ保存する
ダウンロードしたVSIXファイルをUSBメモリや外付けストレージへコピーします。
例えば、次のようにフォルダを作成して管理すると分かりやすくなります。
USBメモリ
└─ vscode
└─ language-pack
└─ MS-CEINTL.vscode-language-pack-ja-x.x.x.vsix
そのUSBメモリを、日本語化したいオフラインPCへ接続します。
オフラインPCへJapanese Language Packをインストールする
VSCodeを起動する
オフラインPCでVSCodeを起動します。
この時点では英語表示のままでも問題ありません。
日本語Language Packをインストールした後で表示言語を変更します。
Extensions画面を開く
VSCode左側の「Extensions」をクリックします。
ショートカットを使う場合は、次のキーを押します。
Ctrl + Shift + X
Install from VSIXを実行する
Extensions画面の右上付近にある「…」メニューをクリックします。
その中から、次の項目を選択してください。
Install from VSIX...
ファイル選択画面が表示されたら、USBメモリなどに保存しておいたJapanese Language PackのVSIXファイルを指定します。
例えば、次のようなファイルです。
MS-CEINTL.vscode-language-pack-ja-x.x.x.vsix
VSIXファイルを選択すると、Language PackがVSCodeへインストールされます。
コマンドパレットからインストールすることもできる
「Install from VSIX…」は、コマンドパレットから実行することもできます。
WindowsやLinuxでは、次のキーを押します。
Ctrl + Shift + P
macOSでは、次のキーを押します。
Command + Shift + P
その後、次のように入力します。
Extensions: Install from VSIX
表示されたコマンドを実行し、VSIXファイルを選択すればインストールできます。
VSCodeの表示言語を日本語に変更する
Configure Display Languageを開く
Japanese Language Packのインストール後、日本語への切り替えを促されることがあります。
そのまま日本語を選択できる場合は、指示に従って切り替えて構いません。
自動的に日本語へ切り替わらない場合は、コマンドパレットから表示言語を指定します。
WindowsやLinuxでは、次のショートカットを押します。
Ctrl + Shift + P
macOSでは、次のショートカットです。
Command + Shift + P
検索欄へ、次のように入力します。
Configure Display Language
表示されたコマンドを選択します。
日本語を選択する
表示言語の一覧から「日本語」を選択します。
日本語のロケールコードは、次のとおりです。
ja
Japanese Language Packが正常にインストールされていれば、日本語を選択できるようになります。
VSCodeを再起動する
表示言語を変更すると、VSCodeの再起動を求められる場合があります。
再起動後に、次のような英語メニューが、
File
Edit
View
次のような日本語表示になっていれば、日本語化は完了です。
ファイル
編集
表示
コマンドラインからVSIXをインストールする方法
codeコマンドを利用する
VSCodeのGUIを使わず、コマンドラインからJapanese Language Packをインストールすることもできます。
VSCodeのcodeコマンドでは、ローカルに保存したVSIXファイルを指定できます。
Windowsで、VSIXファイルが次の場所に保存されているとします。
D:\vscode\MS-CEINTL.vscode-language-pack-ja-x.x.x.vsix
PowerShellやコマンドプロンプトから、次のように実行します。
code --install-extension "D:\vscode\MS-CEINTL.vscode-language-pack-ja-x.x.x.vsix"
macOSやLinuxの場合は、例えば次のように実行します。
code --install-extension ./MS-CEINTL.vscode-language-pack-ja-x.x.x.vsix
オフラインでは拡張機能IDではなくVSIXファイルを指定する
インターネットへ接続できる環境では、拡張機能IDを指定してインストールすることもできます。
しかし、完全なオフライン環境ではMarketplaceへアクセスできません。
そのため、次のように拡張機能IDだけを指定する方法ではなく、
code --install-extension MS-CEINTL.vscode-language-pack-ja
あらかじめ保存しておいたVSIXファイルのパスを指定する必要があります。
code --install-extension Japanese-Language-Pack.vsix
オフライン環境では、この違いを理解しておくことが重要です。
codeコマンドが使えない場合の対処方法
PATHが設定されていない可能性がある
コマンドプロンプトやPowerShellでcodeを実行したときに、次のようなエラーが表示されることがあります。
'code' is not recognized as an internal or external command
PowerShellでは、次のような内容になる場合もあります。
code : 用語 'code' は認識されません
この場合は、VSCodeのcodeコマンドへPATHが通っていない可能性があります。
インストール方法によっては、VSCodeのbinフォルダをPATHへ追加する必要があります。
ただし、オフライン日本語化だけが目的であれば、無理にコマンドラインを使用する必要はありません。
VSCodeの画面から、
Extensions
↓
…
↓
Install from VSIX...
と進めれば、同じようにインストールできます。
Japanese Language Packをインストールしても日本語にならない場合
Language Packが正常にインストールされているか確認する
Extensions画面を開き、検索欄へ次のように入力します。
@installed
インストール済みの拡張機能一覧が表示されます。
その中に、
Japanese Language Pack for Visual Studio Code
が存在するか確認してください。
表示されていなければ、VSIXのインストールが完了していない可能性があります。
Configure Display Languageを確認する
Japanese Language Packがインストール済みでも、表示言語が英語のままになっている場合があります。
その場合は、
Ctrl + Shift + P
から、
Configure Display Language
を開きます。
一覧から「日本語」またはjaを選択してください。
VSCodeを完全に再起動する
表示言語を変更した後は、VSCodeを一度完全に終了して再起動すると確実です。
単にウィンドウを切り替えるだけでは、表示言語が反映されない場合があります。
--locale=jaで日本語を指定する方法
VSCodeには、起動時に表示言語を指定する--localeオプションもあります。
例えば、次のように実行できます。
code --locale=ja
現在のフォルダをVSCodeで開きながら日本語を指定する場合は、次のようにできます。
code . --locale=ja
ただし、--locale=jaを指定しただけでJapanese Language Packがインストールされるわけではありません。
オフライン環境では、先にJapanese Language PackのVSIXをインストールしておく必要があります。
つまり、次の順序になります。
Japanese Language PackをVSIXからインストール
↓
日本語のLanguage Packが利用可能になる
↓
必要に応じて --locale=ja を指定
一般的な利用では、「Configure Display Language」から日本語を選択する方法のほうが簡単です。
VSCodeのバージョンが古い場合の注意点
Language Packのバージョンを確認する
長期間アップデートしていないオフラインPCでは、VSCode本体のバージョンが古い場合があります。
その場合、必ずしも最新のJapanese Language Packを使用する必要はありません。
VSCodeのバージョンによっては、利用可能なLanguage Packのバージョンを選択する必要が生じることがあります。
オンラインPC側で「Download Specific Version VSIX」が利用できる場合は、特定バージョンのLanguage Packを取得できます。
オフライン環境を安定して運用したい場合は、
VSCode本体のバージョン
Language Packのバージョン
その他の拡張機能のバージョン
を記録しておくと管理しやすくなります。
VSIXでインストールしたLanguage Packを更新する方法
オフライン環境では新しいVSIXを持ち込む
VSIXファイルから手動でインストールした拡張機能は、通常のMarketplace経由のインストールとは更新方法が異なります。
完全オフライン環境ではMarketplaceへ接続できないため、Japanese Language Packを更新したい場合も、新しいVSIXファイルを別のPCで取得する必要があります。
基本的には、次の流れになります。
オンラインPCで新しいVSIXを取得
↓
USBメモリなどへ保存
↓
オフラインPCへ移動
↓
新しいVSIXをインストール
VSCode本体を更新した場合は、Language Packやその他の拡張機能についても必要に応じて見直すとよいでしょう。
VSCode本体もオフラインでインストールする場合
VSCode本体とLanguage Packをまとめて準備する
新しいPCへVSCodeそのものをオフラインで導入する場合は、VSCodeのインストーラーとJapanese Language PackのVSIXをまとめて準備しておくと便利です。
例えば、オンラインPCで次のファイルを用意します。
VSCode Offline Kit
│
├─ VSCode
│ └─ VSCodeSetup-x64.exe
│
├─ Language
│ └─ MS-CEINTL.vscode-language-pack-ja-x.x.x.vsix
│
└─ Extensions
├─ Python.vsix
├─ ESLint.vsix
└─ Prettier.vsix
オフラインPCでは、まずVSCode本体をインストールします。
その後、Japanese Language Packや必要な拡張機能をVSIXから順番にインストールします。
このように必要なファイルを一式まとめておけば、複数台のPCでも同じVSCode環境を構築しやすくなります。
参考サイト
オフライン環境へのVisual Studio Codeの導入 #VSCode – Qiita
オフライン環境ではMarketplaceから直接日本語化できない
Configure Display LanguageだけではLanguage Packを取得できない
VSCodeでは「Configure Display Language」を開くと、利用できる言語の候補が表示されることがあります。
しかし、Japanese Language Packがまだインストールされていない状態で新しい言語を追加しようとすると、通常はMarketplaceへのアクセスが必要です。
そのため、完全オフライン環境では、
Configure Display Language
↓
Japanese Language Packをオンライン取得
という方法は利用できません。
先にオンラインPCでVSIXを取得しておく必要があります。
オフライン環境では、次の順序を守るのが重要です。
VSIXを用意
↓
Japanese Language Packをインストール
↓
Configure Display Language
↓
日本語を選択
複数のオフラインPCへ導入する場合
VSIXファイルを共通管理すると便利
企業や学校、閉域ネットワークなどで複数台のPCを管理している場合は、VSIXファイルをまとめて管理すると便利です。
例えば、次のようなフォルダ構成にできます。
vscode-offline
│
├─ vscode-installer
│
├─ language-packs
│ └─ MS-CEINTL.vscode-language-pack-ja-x.x.x.vsix
│
└─ extensions
├─ python.vsix
├─ cpp.vsix
├─ eslint.vsix
└─ prettier.vsix
Japanese Language Packだけでなく、PythonやC/C++、ESLint、Prettierなどの拡張機能もVSIXとして用意しておけば、オフライン開発環境を効率よく構築できます。
VSCodeをオフラインで日本語化する際のポイント
公式のJapanese Language Packを利用する
VSCodeを日本語化するために、非公式の日本語化パッチなどを利用する必要はありません。
Microsoftが提供している「Japanese Language Pack for Visual Studio Code」を利用します。
拡張機能IDは、次のとおりです。
MS-CEINTL.vscode-language-pack-ja
日本語ロケールはja
日本語のロケールコードは、次のとおりです。
ja
Configure Display Languageや--localeを利用するときに使用します。
完全オフラインならVSIXを事前に用意する
最も重要なのは、オフラインPCでMarketplaceへアクセスしようとしないことです。
Japanese Language PackのVSIXを、インターネット接続可能なPCであらかじめ取得しておきます。
まとめ
VSCodeをオフライン環境で日本語化する場合は、「Japanese Language Pack for Visual Studio Code」のVSIXファイルを利用するのが基本です。
最も分かりやすい手順は、次のとおりです。
オンラインPCでVSCodeを起動
↓
Japanese Language Packを検索
↓
Download VSIX
↓
USBメモリなどへ保存
↓
オフラインPCへ移動
↓
VSCodeを起動
↓
Install from VSIX...
↓
Japanese Language Packをインストール
↓
Configure Display Language
↓
日本語を選択
↓
VSCodeを再起動
日本語化に使用する公式拡張機能IDは、次のとおりです。
MS-CEINTL.vscode-language-pack-ja
日本語ロケールは、次のとおりです。
ja
オフライン環境では、Language Packだけでなく、普段使用する拡張機能もVSIX形式でまとめて用意しておくと便利です。
特に複数台のPCをセットアップする場合は、VSCode本体、Japanese Language Pack、必要な拡張機能を「オフラインインストールセット」として管理しておくことで、同じ開発環境を再現しやすくなります。
以上、VSCodeをオフラインで日本語化する方法についてでした。
最後までお読みいただき、ありがとうございました。
