Visual Studio Code

Visual Studio Code は Microsoft によって開発されている、クロスプラットフォームのプロプライエタリテキストエディタ (End-User License Agreement に基づくライセンス) です。JavaScript と TypeScript で書かれた、Codium というフリーのオープンソースプロジェクト(MIT License に基づくライセンス)の上に構築されています。Codium と Visual Studio Code の関係は、Chromium と Google Chrome の関係とほぼ同じです。混合ライセンスの説明については、この GitHub コメントを参照してください。Visual Studio Code は Electron フレームワーク上に構築されており、エクステンションによる拡張ができます。拡張は web上 または テキストエディタの中 から参照できます。

インストール

Visual Studio Code は以下のフレーバが提供されています:

• Code - OSS — 公式の Arch Linux オープンソースリリース。Open VSX を有効化する設定が同梱されています。

https://github.com/microsoft/vscode || code, code-git^AUR

• Visual Studio Code — プロプライエタリな Microsoft ブランドのリリース。

https://code.visualstudio.com/ || visual-studio-code-bin^AUR, visual-studio-code-insiders-bin^AUR

• VSCodium — コミュニティのオープンソースリリース。ソースコード内でテレメトリが無効化されており [1]、Open VSX の設定も同梱されています。

https://vscodium.com/ || vscodium^AUR, vscodium-bin^AUR, vscodium-git^AUR, vscodium-electron^AUR

これらの異なるフレーバはすべて Code - OSS リポジトリからビルドされていますが、ライセンスとデフォルトの設定が異なっています。特に、プロプライエタリなビルドだけが、Microsoft の marketplace 使用と (OmniSharp C# Debugger などの) Microsoft のプロプライエタリな拡張機能の使用を許可されています。後者はハンドシェイク機構によって強制されており、回避することはできません。"Visual Studio Code" ブランドのオープンソースビルドとプロプライエタリビルドの違いに関する詳細は、Code - OSS GitHub wiki を見てください。

拡張機能のサポート

Code の主な強みの1つとして、柔軟な API と Visual Studio Marketplace 上でホストされていますリッチな拡張エコシステムがあります。しかし、marketpace の利用規約は Microsoft ブランドのリリースのみでの使用を許可しています。そのため、Code - OSS source には、設定済みの marketplace が含まれていません。上記のオープンソースのリリースは、Open VSIX 拡張レジストリを追加しますが、拡張機能の数は劣ります。この制限を回避することは可能です。

警告: Microsoft はこの問題に直接コメントしてはいませんが、ノンブランドの Code ビルドは、利用規約で定められている "In-Scope Products and Services" (「対象の製品とサービス」)に含まれないと合理的に結論づけることができます。つまり、この行為は marketplace によって許可されていません。FS#67780 も参照してください。

既知の回避策は:

• .vsix ファイルから手動で拡張機能をインストールする。.vsix ファイルは Microsoft Visual Studio Code Marketplace から入手できます。
• 拡張機能のメンテナに拡張機能を Open VSX registry にアップロードするように依頼する。
• 次のパッケージのうち、あなたが使用しているビルドと関連するものを使って、Microsoft Visual Studio Code Marketplace を追加する: code-marketplace^AUR/vscodium-bin-marketplace^AUR/vscodium-marketplace^AUR。

これらのパッケージは、パッケージ更新のたびにこの Github コメントにあるように product.json ファイルにパッチを適用する Pacman フックをインストールします。

ヒント: product.json の変更時にIDE をリロードするキーボードショートカットを有効化すると便利です。

使用方法

code を実行してください。

何らかの理由で Visual Studio Code のインスタンスを複数起動したい場合、-n フラグを使ってください。

設定

code の設定は ~/.config/Code - OSS/User/settings.json に保存されます。

visual-studio-code-bin^AUR の設定は ~/.config/Code/User/settings.json に保存されます。

vscodium^AUR 及びその他 Codium の設定は ~/.config/VSCodium/User/settings.json に保存されます。

Code から Codium (またはその逆) へ設定を移行する場合、設定ディレクトリはコピーまたは移動できます。殆どのコードベースを共有しているため設定には互換性があります。

統合ターミナル

View > Integrated Terminal や Ctrl + ` で統合されたターミナルが開きます。デフォルトでは、何も引数が指定されないと Bash が使われますが、使用されるシェルは変更できます。terminal.integrated.shell.linux は使用するデフォルトシェルを設定し、terminal.integrated.shellArgs.linux はシェルに渡される引数を設定します。

例:

~/.config/Code/User/settings.json

"terminal.integrated.shell.linux": "/usr/bin/fish",
"terminal.integrated.shellArgs.linux": ["-l","-d 3"]

外部ターミナル

Arch のデフォルトターミナルとして Terminator を使っている場合、Visual Studio Code で次のようなエラーが発生します: Unable to launch debugger worker process (vsdbg) through the terminal. spawn truecolor ENOENT。Visual Studio で使用するターミナルを別のターミナルに変更することで解決します (例: gnome-terminal)。

"terminal.external.linuxExec": "Yours alternative terminal" で実行・デバッグのときに使用するデフォルトのターミナルを設定します。

例:

~/.config/Code/User/settings.json

"terminal.external.linuxExec": "gnome-terminal"

Wayland でのネイティブ実行

Wayland ベースの WM や DE を使用している場合、コマンドラインオプションに、--enable-features=UseOzonePlatform --ozone-platform=wayland を追加することで、Visual Studio Code を XWayland ではなく、Wayland でネイティブに実行させることができます。例えば、次のようにして、VSCode を起動してみてください。

$ code --enable-features=UseOzonePlatform --ozone-platform=wayland

これらのオプションは、${XDG_CONFIG_HOME}/electron-flags.conf ファイルに追加することで、Visual Studio Code が起動するたびに自動的に適用されます。現在の vscode バイナリがビルドされている electron のバージョンによっては正確な electron バージョン用の別の設定ファイル (例: ${XDG_CONFIG_HOME}/electron13-flags.conf) が必要になることがあります。(Wayland#Electron を参照)。

トラブルシューティング

KDE/Plasma でグローバルメニューが機能しない

Visual Studio Code は DBus を使用してメニューを Plasma に渡します。libdbusmenu-glib をインストールしてみてください。

アイテムをゴミ箱に移動できない

Electron アプリはデフォルトでは gio を使用してファイルを削除します。Plasma が検出されると、代わりに kioclient5 が自動的に選択されます。環境変数 ELECTRON_TRASH を設定することにより、さまざまなゴミ箱の実装を使用できます。

例えば、trash-cli を使ったファイル削除の場合。

$ ELECTRON_TRASH=trash-cli code

本稿執筆時点で、Electron は kioclient5, kioclient, trash-cli, gio (デフォルト) および gvfs-trash（非推奨）をサポートしています。詳細はこちらの documentation page で確認できます。

Unable to debug C#

If you want to debug C#.NET (using the OmniSharp extension) then you need to install the Microsoft branded release (from the AUR). This is apparently because the .NET Core debugger is only licensed to be used with official Microsoft products - see this github discussion.

When using the open-source package, debugging fails fairly quietly. The debug console will just show the initial message:

You may only use the Microsoft .NET Core Debugger (vsdbg) with
Visual Studio Code, Visual Studio or Visual Studio for Mac software
to help you develop and test your applications.

For debugging with the open-source package netcoredbg^AUR can be used. To run it in VS Code, add this configuration to .NET Core launch configuration of the project:

./.vscode/launch.json

"configurations": [
    {
...
    "pipeTransport": {
        "pipeCwd": "${workspaceFolder}",
        "pipeProgram": "/usr/bin/bash",
        "pipeArgs": ["-c"],
        "debuggerPath": "/usr/bin/netcoredbg"
    }
...

Unable to open .csproj with OmniSharp server, invalid Microsoft.Common.props location

mono から適切な SDK バージョンの props に変更する必要があります。

/opt/dotnet/sdk/{VERSION}/Sdks/Microsoft.NET.Sdk/Sdk/Sdk.props

$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props

インポートを次のように変更します。

/opt/dotnet/sdk/{VERSION}/Sdks/Microsoft.NET.Sdk/Sdk/Sdk.props

/opt/dotnet/sdk/{VERSION}/Current/Microsoft.Common.props

Error from OmniSharp that MSBuild cannot be located

It is noted in the OmniSharp introduction that Arch Linux users should install the mono-msbuild package. Without it, you might get an error like:

OmniSharp Log

[info]: OmniSharp.MSBuild.Discovery.MSBuildLocator
        Registered MSBuild instance: StandAlone 15.0 - "~/.vscode/extensions/ms-vscode.csharp-1.18.0/.omnisharp/1.32.11/omnisharp/msbuild/15.0/Bin"
            MSBuildExtensionsPath = /usr/lib/mono/xbuild
            BypassFrameworkInstallChecks = true
            CscToolPath = ~/.vscode/extensions/ms-vscode.csharp-1.18.0/.omnisharp/1.32.11/omnisharp/msbuild/15.0/Bin/Roslyn
            CscToolExe = csc.exe
            MSBuildToolsPath = ~/.vscode/extensions/ms-vscode.csharp-1.18.0/.omnisharp/1.32.11/omnisharp/msbuild/15.0/Bin
            TargetFrameworkRootPath = /usr/lib/mono/xbuild-frameworks
System.TypeLoadException: Could not load type of field 'OmniSharp.MSBuild.ProjectManager:_queue' (13) due to: Could not load file or assembly 'System.Threading.Tasks.Dataflow, Version=4.5.24.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a' or one of its dependencies.
...

You might be able to build anyway (possibly depending whether you have mono installed too).

Omnisharp ships with its own mono version, so, if it is unable to locate the installed one, if you want to tell omnisharp to look for a "global" mono installed in your machine, put this in your settings.json:

settings.json

"omnisharp.useGlobalMono:"always"

"Retry as Sudo" での保存がうまくいかない

Microsoft は Arch パッケージのパッケージ方法 (バンドルされた Electron ではなくネイティブ) をサポートしていないため、この機能は code パッケージでは動きません。詳しくは FS#61516 とアップストリームのバグレポートをご確認ください。

バイナリリリースの visual-studio-code-bin^AUR にはこの問題はなく、この機能は動作します。

キーボードのバリアントやキーマッピングがマッピングされない

GitHub の wiki によると、

一部の Linux ウィンドウマネージャでキーボードレイアウトを切り替えても、VS Code が現在のキーボードレイアウトを読み取るために使用する低レベルの X ウィンドウ API に変更が生じません。このため、VS Code は、現在アクティブなキーボードレイアウトではなく、他の設定されたキーボードレイアウトの 1 つを読み取ることになる場合があることを意味します。PR 歓迎...

wiki によると、2 つの可能な解決策があります。

1. setxkbmap -query が最初のキーボードレイアウトとして、VS Codeで作業したいものを返すことを確認する。
2. "keyboard.dispatch": "keyCode" を使用し、VS Codeを再起動します。これで、VS Code がキーボードレイアウトを決定しようとするのを防ぐことができます。

Command "..." not found

In the official build of VS Code, a product.json file lists the extensions that are allowed to use certain proposed APIs accessed by extensions. However, the product.json is absent in the OSS build code. [2]

In the related issues below, some flags may be required to enable certain APIs. [3] You may either run code with these flags, or you can add the relevant entries to the extensionAllowedProposedApi section in the product.json file (code installs this to /usr/lib/code/product.json).

"extensionAllowedProposedApi": [
    "ms-vsliveshare.vsliveshare",
    "ms-vscode.node-debug",
    "ms-vscode.node-debug2"
]

This can also be resolved by installing the code-features^AUR package, which installs a pacman hook that patches the file on every package update. Alternatively, you may also consider installing the Microsoft branded packages: visual-studio-code-bin^AUR, visual-studio-code-insiders-bin^AUR.

VS Live Share missing API

Use either the solution above by editing the product.json, or open VS Code with:

$ code --enable-proposed-api ms-vsliveshare.vsliveshare

Command 'remote-containers.openFolder' not found

Open VS Code enabling remote-containers API as commented in FS#63374:

$ code-oss --enable-proposed-api ms-vscode-remote.remote-containers

Command 'GitHub Pull Requests: Configure Remotes...' resulted in an error (command 'pr.configureRemotes' not found)

以下のように VS Code を開きます。

$ code --enable-proposed-api GitHub.vscode-pull-request-github

Git: ssh_askpass: exec(/usr/lib/ssh/ssh-askpass): No such file or directory

このエラーは ssh-key が暗号化されているために発生するもので、 SSH 鍵#x11-ssh-askpass のようなダイアログプロバイダや、KDE 用の ksshaskpass などの代替品をインストールすることで解決します。

注意点としては、例えば ksshaskpass の場合、VSCode に見つけてもらうために、/usr/lib/ssh/ssh-askpass からリンクする必要があることです。

# ln /usr/bin/ksshaskpass /usr/lib/ssh/ssh-askpass

統合端末のカットオフ文字

幅が広すぎる文字は、クリッピングしてしまうことがあります。例えば、Deno のスタックトレースのイタリック体の太字など。

"terminal.integrated.rendererType" を "experimentalWebgl" に設定することで、これを回避することができます。

Waylandでの文字化け

Visual Studio Code はデフォルトで XWayland で実行されるため、HiDPI スクリーンを使用している場合、文字がぼやけてしまうことがあります。この問題を解決するには、Electron を強制的に Wayland で実行するようにしてください（#Wayland でのネイティブ実行 を参照）。

No such interface“org.freedesktop.Secret.Collection”

settings-sync#_troubleshooting-keychain-issues を参照してください。

VSCodium 使用時に Github との認証に失敗する

Github アカウントに接続する場合、このコメントにあるように URLの 「vscodium」を「vscode」に変更します。その後、識別トークンを VSCodium にコピーします。それでも失敗する場合は、Visual Studio Code docs や Github にあるように、gnome-keyring のようなキーリングをインストールするか、新しいキーリングを作成します。

一貫性のないファイルダイアログ

現在、vscodium は kde でも gtk ファイルダイアログを開きます。詳細については、Qt と GTK アプリケーションの外観の統合#Consistent file dialog を参照してください。