「Visual Studio Code」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(→‎インストール: 英語版より記事を追加)
(同期)
 
(4人の利用者による、間の58版が非表示)
1行目: 1行目:
−
[[Category:開発]]
  
 
[[Category:テキストエディタ]]
  
[[Category:テキストエディタ]]
 
[[en:Visual Studio Code]]
  
[[en:Visual Studio Code]]
  +
[[pt:Visual Studio Code]]
  +
[[ru:Visual Studio Code]]
 
[[zh-hans:Visual Studio Code]]
  
[[zh-hans:Visual Studio Code]]
−
[https://code.visualstudio.com/ Visual Studio Code] は Microsoft によって開発されている、クロスプラットフォームのプロプライエタリテキストエディタ (End-User License Agreement に基づくライセンス) です。JavaScript と TypeScript で書かれた、Codium というフリーのオープンソースプロジェクト(MIT License に基づくライセンス)の上に構築されています。Codium と Visual Studio Code の関係は、Chromium と Google Chrome の関係とほぼ同じです。混合ライセンスの説明については、[https://github.com/Microsoft/vscode/issues/60#issuecomment-161792005 この GitHub コメント]を参照してください。Visual Studio Code は Electron フレームワーク上に構築されており、エクステンションによる拡張ができます。拡張は [https://marketplace.visualstudio.com/VSCode web上] または テキストエディタの中 から参照できます。
 +
[https://code.visualstudio.com/ Code] とは、Microsoft によって開発されているクロスプラットフォームのテキストエディタで、Electron フレームワーク上でビルドされています。''Visual Studio Code'' は、MIT ライセンス [https://github.com/microsoft/vscode/ Code - OSS] リポジトリの1つのバイナリディストリビューションで、Microsoft 特有のカスタマイズがなされており、[https://code.visualstudio.com/license プロプライエタリライセンス]のもとでリリースされています。この混合ライセンスに関する詳細は、[https://github.com/Microsoft/vscode/issues/60#issuecomment-161792005 この GitHub コメント]を見てください。また、MIT ライセンスの [https://vscodium.com/ VSCodium] というバイナリリリースもあり、これはコミュニティで運営されていて、[https://code.visualstudio.com/docs/getstarted/telemetry テレメトリ] がデフォルトで無効化されています。
   
 
== インストール ==
  
== インストール ==
−
VSCode には以下のパッケージが存在します:
  
   
  +
Visual Studio Code は以下のフレーバが提供されています:
−
* {{Pkg|code}}
  
−
* {{AUR|code-git}}
  
−
* {{AUR|visual-studio-code-bin}}
  
−
* {{AUR|visual-studio-code-insiders-bin}} (Microsoft-branded release, updated daily)
  
−
* {{AUR|vscodium-bin}} (community-driven fully open-source version of VSCode, with all Microsoft telemetry stripped out - latest release, binary package)
  
−
* {{AUR|vscodium}} (community-driven fully open-source version of VSCode, with all Microsoft telemetry stripped out - latest release, git build)
  
−
* {{AUR|vscodium-git}} (community-driven fully open-source version of VSCode, with all Microsoft telemetry stripped out - latest commit on branch master, git build)
  
   
  +
* {{App|Code - OSS|公式の Arch Linux オープンソースリリース。[https://open-vsx.org/ Open VSX] を有効化する設定が同梱されています。|https://github.com/microsoft/vscode|{{Pkg|code}}}}
−
The Microsoft [https://github.com/microsoft/ptvsd ptvsd] (Python Tools for Visual Studio Debug) server/module is available at {{AUR|python-ptvsd}}.
  
  +
* {{App|Visual Studio Code|プロプライエタリな Microsoft ブランドのリリース。|https://code.visualstudio.com/|{{AUR|visual-studio-code-bin}}}}
  +
* {{App|VSCodium|コミュニティのオープンソースリリース。ソースコード内でテレメトリが無効化されており [https://github.com/VSCodium/vscodium/issues/267#issuecomment-542462446]、Open VSX の設定も同梱されています。|https://vscodium.com/|{{AUR|vscodium}}}}
   
  +
これらの異なるフレーバはすべて [https://github.com/VSCodium/vscodium/blob/master/README.md Code - OSS リポジトリ]からビルドされていますが、ライセンスとデフォルトの設定が異なっています。特に、プロプライエタリなビルドだけが、Microsoft の marketplace 使用と ([https://github.com/OmniSharp/omnisharp-vscode/blob/master/debugger.md OmniSharp C# Debugger] などの) Microsoft のプロプライエタリな拡張機能の使用を許可されています。後者はハンドシェイク機構によって強制されており、迂回することはできません。"Visual Studio Code" ブランドのオープンソースビルドとプロプライエタリビルドの違いに関する詳細は、[https://github.com/microsoft/vscode/wiki/Differences-between-the-repository-and-Visual-Studio-Code Code - OSS GitHub wiki] を見てください。
−
===C# のデバッグ===
  
  +
−
C# のコードをデバッグするには {{AUR|icu55}} をインストールする必要があります。インストールしないと 'Debug adapter process has terminated unexpectedly' というエラーが発生します。
  
  +
=== 拡張機能のサポート ===
  +
  +
Code の主な強みの1つとして、柔軟な API と [https://marketplace.visualstudio.com/vscode Visual Studio Marketplace] 上でホストされていますリッチな拡張エコシステムがあります。しかし、[https://aka.ms/vsmarketplace-ToU marketpace の利用規約] は Microsoft ブランドのリリースのみでの使用を許可しています。そのため、Code - OSS source には、設定済みの marketplace が含まれていません。上記のオープンソースのリリースは、Open VSIX 拡張レジストリを追加しますが、拡張機能の数は劣ります。この制限を回避することは可能です。
  +
  +
{{Warning|Microsoft は[https://github.com/Microsoft/vscode/issues/31168 この問題に直接コメントしてはいません] が、ノンブランドの Code ビルドは、利用規約で定められている "対象範囲内の製品およびサービス" に含まれないと合理的に結論づけることができます。つまり、この行為は marketplace によって許可されていません。{{Bug|67780}} も参照してください。}}
  +
  +
既知の回避策は:
  +
* {{ic|.vsix}} ファイルから手動で拡張機能をインストールする。{{ic|.vsix}} ファイルは [https://marketplace.visualstudio.com/ Microsoft Visual Studio Code Marketplace] から入手できます。
  +
* 拡張機能のメンテナに拡張機能を [https://open-vsx.org/ Open VSX registry] にアップロードするように依頼する。
  +
* 次のパッケージのうち、あなたが使用しているビルドと関連するものを使って、Microsoft Visual Studio Code Marketplace を追加する: {{AUR|code-marketplace}}/{{AUR|vscodium-bin-marketplace}}/{{AUR|vscodium-marketplace}}/{{AUR|code-oss-marketplace}}。これらのパッケージは、パッケージ更新のたびにこの [https://github.com/VSCodium/vscodium/issues/418#issuecomment-643664182 Github コメント]にあるように {{ic|product.json}} ファイルにパッチを適用する [[Pacman フック]] をインストールします。
  +
  +
{{Tip|{{ic|product.json}} の変更を実験する際に[https://stackoverflow.com/a/69985500 IDE をリロードするキーボードショートカット] を有効化すると便利です。}}
   
 
== 使用方法 ==
  
== 使用方法 ==
   
  +
{{ic|code}} を実行して、アプリケーションを起動します (または、他のリリースを使用している場合、{{AUR|code-git}} は {{ic|code-git}} を、{{AUR|vscodium-bin}}/{{AUR|vscodium}}/{{AUR|vscodium-git}} は {{ic|codium}} を実行します)。
−
{{ic|code}} を実行してください。
  
   
−
何らかの理由で Visual Studio Code のインスタンスを複数起動したい場合、{{ic|-n}} フラグを使ってください。
 +
何らかの理由で Visual Studio Code の複数のインスタンスを起動した場合、{{ic|-n}} フラグを使用できます。
   
−
==設定==
 +
== 設定 ==
   
−
Visual Studio Code の設定は {{ic|~/.config/Code/User/settings.json}} に保存されます。
 +
{{Pkg|code}} は設定を {{ic|~/.config/Code - OSS/User/settings.json}} に保存します。
   
  +
{{AUR|visual-studio-code-bin}} は設定を {{ic|~/.config/Code/User/settings.json}} に保存します。
−
===統合ターミナル===
  
   
  +
{{AUR|vscodium}} や関連するパッケージは設定を {{ic|~/.config/VSCodium/User/settings.json}} に保存します。
−
{{ic|View > Integrated Terminal}} や {{ic|Ctrl + `}} で統合されたターミナルが開きます。デフォルトでは、何も引数が指定されないと [[Bash]] が使われますが、使用されるシェルは変更できます。{{ic|terminal.integrated.shell.linux}} は使用するデフォルトシェルを設定し、{{ic|terminal.integrated.shellArgs.linux}} はシェルに渡される引数を設定します。
  
  +
  +
Code から Codium に (またはその逆) 移行する場合、設定ディレクトリはコピー/移動することができます。設定はコードベースの殆どを共有しているので、互換性があります。
  +
  +
=== 統合ターミナル ===
  +
  +
''View > Integrated Terminal'' や {{ic|Ctrl + `}} で統合ターミナルが開きます。
  +
デフォルトでは追加の引数がない場合に [[Bash]] が使用されますが、この挙動は変更できます。
  +
{{ic|terminal.integrated.shell.linux}} はデフォルトのシェルを設定し、{{ic|terminal.integrated.shellArgs.linux}} はそのシェルに渡される引数を設定します。
   
 
例:
  
例:
42行目: 58行目:
 
}}
  
}}
   
  +
外部ターミナルで統合シェルの引数を設定するとプロンプトがおかしくなる場合があります。その行を削除してこの問題を解決するか、外部ターミナルを使用してください。
−
===外部ターミナル===
  
   
  +
=== 外部ターミナル ===
−
Arch のデフォルトターミナルとして [[Terminator]] を使っている場合、Visual Studio Code で次のようなエラーが発生します: {{ic|Unable to launch debugger worker process (vsdbg) through the terminal. spawn truecolor ENOENT}}。Visual Studio で使用するターミナルを別のターミナルに変更することで解決します (例: gnome-terminal)。
  
   
  +
Arch のデフォルトターミナルとして [[Terminator]] を使っている場合、Visual Studio Code で次のようなエラーが発生します: {{ic|Unable to launch debugger worker process (vsdbg) through the terminal. spawn truecolor ENOENT}}。Visual Studio で使用するターミナルを別のターミナルに変更することで解決します (例: {{Pkg|gnome-terminal}})。
−
{{ic|"terminal.external.linuxExec": "Yours alternative terminal"}} で実行・デバッグのときに使用するデフォルトのターミナルを設定します。
  
  +
  +
{{ic|"terminal.external.linuxExec": "Your alternative terminal"}} で実行デバッグのときに使用するデフォルトのターミナルを設定します。
   
 
例:
  
例:
53行目: 71行目:
 
"terminal.external.linuxExec": "gnome-terminal"
  
"terminal.external.linuxExec": "gnome-terminal"
 
}}
  
}}
  +
  +
=== Wayland でネイティブに実行する ===
  +
  +
Visual Studio Code は Electron を使います。VSCode を Wayland 上でネイティブに動かす方法についての詳細は [[Wayland#Electron]] を見てください。しかし、一部のアプリケーションはシステムの electron を使用せず、独自のものを使用します。そのようなアプリケーションは標準の Electron フラグファイルを読み込みません。
  +
  +
ユーザ毎の設定ファイルを使用する場合、{{AUR|visual-studio-code-bin}} と {{Pkg|code}} は両方 {{ic|~/.config/code-flags.conf}} を読み込みます。これらのパッケージは、これらのオプションを読み込む[https://aur.archlinux.org/cgit/aur.git/tree/visual-studio-code-bin.sh?h=visual-studio-code-bin パッチを当てたローダスクリプト]を使用するので、この挙動はこれらのパッケージ固有のものであることに注意してください。
  +
  +
{{AUR|vscodium-bin}} を使用する場合、{{ic|~/.config/codium-flags.conf}} ファイルを使用してください。ターミナルから実行する場合、({{ic|vscodium}} ではなく) {{ic|codium}} で実行してください。さもないと、ネイティブな Wayland ウィンドウが使用されません。
  +
  +
{{AUR|vscodium}} は設定ファイルを読み込みません (パッチを当てたローダスクリプトを使用しないからです)。
  +
  +
=== ネイティブなファイル選択ダイアログ ===
  +
  +
KDE を使用している場合、デフォルトでは VS Codium は GTK のファイル選択ダイアログを開きます。これを修正するには、[[環境変数]] {{ic|1=GTK_USE_PORTAL=1}} を設定してください。
  +
  +
== トラブルシューティング ==
  +
  +
=== KDE/Plasma でグローバルメニューが機能しない ===
  +
  +
Visual Studio Code は DBus を使用してメニューを Plasma に渡します。{{Pkg|libdbusmenu-glib}} をインストールしてみてください。[https://github.com/microsoft/vscode/issues/34510#issuecomment-364896975]
  +
  +
=== アイテムをゴミ箱に移動できない ===
  +
  +
デフォルトでは、[https://electron.atom.io/ Electron] アプリは {{ic|gio}} を使用してファイルを削除します。[[Plasma]] が検出されると、代わりに {{ic|kioclient5}} が自動的に選択されます。[[環境変数]] {{ic|ELECTRON_TRASH}} を設定することにより、異なるゴミ箱の実装を使用できます。
  +
  +
例えば、{{Pkg|trash-cli}} を使ってファイルを削除する場合:
  +
  +
$ ELECTRON_TRASH=trash-cli code
  +
  +
本稿執筆時点で、Electron は {{ic|kioclient5}}、{{ic|kioclient}}、{{ic|trash-cli}}、{{ic|gio}} (デフォルト)、{{ic|gvfs-trash}} (非推奨) をサポートしています。詳細はこちらの [https://github.com/electron/electron/blob/master/docs/api/environment-variables.md#electron_trash-linux ドキュメントページ]
  +
で確認できます。
  +
  +
=== C# をデバッグできない ===
  +
  +
C#[[.NET]] を ([https://www.omnisharp.net OmniSharp 拡張機能]を使って) デバッグしたい場合、Microsoft ブランドの .NET リリースを (AUR から) インストールする必要があります。これは、.NET Core デバッガーが公式の Microsoft 製品でのみ使用できるようにライセンスされているからだと思われます。[https://github.com/OmniSharp/omnisharp-vscode/issues/1431#issuecomment-297578930 GitHub のディスカッション]を見てください。
  +
  +
オープンソース版のパッケージを利用している場合は、デバッグは静かなメッセージで失敗します。デバッグコンソールは最初のメッセージが出力されるだけです:
  +
  +
{{bc|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.}}
  +
  +
オープンソース版のパッケージでデバッグする場合、{{AUR|netcoredbg}} を利用できます。VS Code で実行するには、以下の設定をこのプロジェクトの .NET Core launch 設定に追加してください:
  +
  +
{{hc|./.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 に変更する必要があります。
  +
  +
{{hc|/opt/dotnet/sdk/{VERSION}/Sdks/Microsoft.NET.Sdk/Sdk/Sdk.props|
  +
$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props
  +
}}
  +
  +
インポートを次のように変更します。
  +
  +
{{hc|/opt/dotnet/sdk/{VERSION}/Sdks/Microsoft.NET.Sdk/Sdk/Sdk.props|
  +
/opt/dotnet/sdk/{VERSION}/Current/Microsoft.Common.props
  +
}}
  +
  +
=== MSBuild が見つからないと OmniSharp でエラーが発生する ===
  +
  +
[https://github.com/OmniSharp/omnisharp-roslyn#introduction OmniSharp introduction] で説明されている通り、Arch Linux ユーザは {{Pkg|mono-msbuild}} パッケージをインストールする必要があります。それがないと、以下のようなエラーが発生するかもしれません:
  +
  +
{{hc|1=OmniSharp Log|2=
  +
[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.
  +
...}}
  +
  +
もしかするとビルドできるかもしれません (おそらく、{{Pkg|mono}} がインストールされているかどうかにも依存しているのでしょう)
  +
  +
Omnisharp には独自の mono バージョンが同梱されています。Omnisharp がインストール済みの mono を見つけられない場合で、マシンにインストールされている "グローバルな" mono を検索するよう omnisharp を設定したい場合、以下を settings.json に追加してください:
  +
{{hc|1=settings.json|2="omnisharp.useGlobalMono:"always"}}
  +
  +
=== "Retry as Sudo" での保存がうまくいかない ===
  +
  +
Microsoft は Arch パッケージのパッケージング方法 (バンドルされた Electron ではなくネイティブ) をサポートしていないため、この機能は {{Pkg|code}} パッケージでは動きません。詳しくは {{Bug|61516}} と[https://github.com/Microsoft/vscode/issues/70403 上流のバグレポート]をご確認ください。
  +
  +
バイナリリリースの {{AUR|visual-studio-code-bin}} にはこの問題はなく、この機能は動作します。
  +
  +
=== キーボードのバリアントやキーマッピングがマッピングされない ===
  +
  +
[https://github.com/Microsoft/vscode/wiki/Keybinding-Issues#troubleshoot-linux-keybindings GitHub の wiki] によると、
  +
  +
: 一部の Linux ウィンドウマネージャでキーボードレイアウトを切り替えても、VS Code が現在のキーボードレイアウトを読み取るために使用する低レベルの X ウィンドウ API に変更が生じません。このため、VS Code は、現在アクティブなキーボードレイアウトではなく、他の設定されたキーボードレイアウトの 1 つを読み取ることになる場合があることを意味します。PR 歓迎...
  +
  +
wiki によると、2 つの可能な解決策があります。
  +
  +
# {{ic|setxkbmap -query}} が最初のキーボードレイアウトとして、VS Codeで作業したいものを返すことを確認する。
  +
# {{ic|"keyboard.dispatch": "keyCode"}} を使用し、VS Codeを再起動します。これで、VS Code がキーボードレイアウトを決定しようとするのを防ぐことができます。
  +
  +
=== Command "..." not found ===
  +
  +
Microsoft ブランドのリリースでは、拡張機能によってアクセスされる提案された特定の API の使用を許可されている拡張機能が {{ic|product.json}} ファイルにリストアップされています。Code - OSS と VSCodium にはこれらの値が存在しません (しかし、これはライセンスの問題というわけではないようです)。Marketplace の強制的な有効化とは異なり、以下の回避策は Microsoft によって推奨されています [https://docs.microsoft.com/en-us/visualstudio/liveshare/reference/linux#vs-code-oss-issues]。
  +
  +
この問題は、パッケージアップデートの時にそのファイルにパッチを当てる Pacman フックを導入することで解決できます:
  +
  +
* {{Pkg|code}} の場合、{{AUR|code-features}} を[[インストール]]してください
  +
* {{AUR|vscodium}} の場合、{{AUR|vscodium-features}} をインストールしてください
  +
* {{AUR|vscodium-bin}} の場合、{{AUR|vscodium-bin-features}} をインストールしてください
  +
  +
また、関連するエントリを {{ic|product.json}} ファイルの {{ic|extensionAllowedProposedApi}} セクションに手動で追加することもできます:
  +
  +
* {{Pkg|code}} の場合、{{ic|/usr/lib/code/product.json}} を編集してください
  +
* {{AUR|vscodium}} の場合、{{ic|/usr/share/vscodium/resources/app/product.json}} を編集してください
  +
* {{AUR|vscodium-bin}} の場合、{{ic|/opt/vscodium-bin/resources/app/product.json}} を編集してください
  +
  +
Live Share を機能させる手動設定の例は [https://docs.microsoft.com/en-us/visualstudio/liveshare/reference/linux#vs-code-oss-issues]:
  +
  +
{{hc|product.json|
  +
...
  +
"extensionAllowedProposedApi": [
  +
"ms-vsliveshare.vsliveshare",
  +
"ms-vscode.node-debug",
  +
"ms-vscode.node-debug2"
  +
]
  +
...
  +
}}
  +
  +
最後に、[https://github.com/Microsoft/vscode-pull-request-github/wiki#3-why-isnt-the-extension-starting GitHub のプルリクエスト拡張で説明されているように]、コマンドラインフラグを使ってこれらのオプションを有効化することもできます。
  +
  +
==== VS Live Share で API が欠けている ====
  +
  +
{{ic|product.json}} を編集して上記の解決策を試すか、以下のオプションで VS Code を開いてください:
  +
  +
$ code --enable-proposed-api ms-vsliveshare.vsliveshare
  +
  +
また、この拡張機能を機能させるには、[https://docs.microsoft.com/en-us/visualstudio/liveshare/reference/linux#tips-for-community-supported-distros] にリストアップされている依存関係をインストールする必要があります。
  +
  +
==== Command 'remote-containers.openFolder' not found ====
  +
  +
{{bug|63374}} でコメントされているように、remote-containers API を有効化して VS Code を開いてください:
  +
  +
$ 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 エージェントを使用できないため発生します。[https://github.com/microsoft/vscode/issues/57488 バグレポート]を見てください。この問題は、[[SSH 鍵#x11-ssh-askpass]] のようなダイアログプロバイダか、代替品 (例えば、KDE の {{Pkg|ksshaskpass}}) をインストールすることで解決できます。
  +
  +
注意点としては、''ksshaskpass'' の場合、{{ic|/usr/lib/ssh/ssh-askpass}} からリンクを貼って VSCode がそれを見つけられるようにする必要があります:
  +
  +
# ln /usr/bin/ksshaskpass /usr/lib/ssh/ssh-askpass
  +
  +
または、以下の[[環境変数]]をシェルで設定してください ([https://github.com/microsoft/vscode/issues/57488#issuecomment-1413903793] を参照):
  +
  +
GIT_ASKPASS=ksshaskpass
  +
SSH_ASKPASS=ksshaskpass
  +
SSH_ASKPASS_REQUIRE=prefer
  +
  +
VSCode の内部 ''git-askpass'' を無効化するには、以下を追加してください:
  +
  +
{{hc|~/.config/Code - OSS/User/settings.json|2=
  +
{
  +
"git.useIntegratedAskPass": false
  +
}
  +
}}
  +
  +
=== 統合ターミナルで文字が切れる ===
  +
  +
幅が大きすぎる文字は、切れてしまう場合があります。例えば、Deno stack-traces のイタリック太文字テキストなどです。
  +
  +
この問題は、"terminal.integrated.rendererType" を "experimentalWebgl" に設定することで回避できます。
  +
  +
=== Wayland でテキストがぼやける ===
  +
  +
Visual Studio Code はデフォルトで Xwayland 下で実行されます。そのせいで、HiDPI スクリーンを使用している場合にテキストがぼやける場合があります。この問題を修正するには、Electron を Wayland 下で実行するように強制してみてください。[[#Wayland でネイティブに実行する]] を見てください。
  +
  +
あるいは、あなたの Wayland 環境が Xwayland アプリケーションをスケーリングせずに実行するオプションを提供している場合、この問題を回避できます。この場合、Visual Studio Code を {{ic|1=--force-device-scale-factor=}} オプション付きで実行して画面に合う適切なスケールを使用してください。
  +
  +
例えば、スケールファクタ 2 の場合は:
  +
  +
$ code --force-device-scale-factor=2
  +
  +
=== No such interface“org.freedesktop.Secret.Collection” ===
  +
  +
[https://code.visualstudio.com/docs/editor/settings-sync#_troubleshooting-keychain-issues settings-sync#_troubleshooting-keychain-issues] を参照してください。
  +
  +
=== VSCodium 使用時に Github との認証に失敗する ===
  +
  +
Github アカウントに接続する場合、[https://github.com/VSCodium/vscodium/issues/401#issuecomment-631502370 このコメント]にあるように URLの "vscodium" を "vscode" に変更します。次に、識別トークンを VSCodium にコピーします。それでも失敗する場合は、[https://code.visualstudio.com/docs/editor/settings-sync#_troubleshooting-keychain-issues Visual Studio Code docs] や [https://github.com/microsoft/vscode/issues/92972#issuecomment-625751232 Github] で説明されているように、{{pkg|gnome-keyring}} のようなキーリングをインストールするか、新しいキーリングを作成してください。
  +
  +
=== An OS keyring couldn't be identified ===
  +
  +
i3 などの一部のデスクトップ環境では、VSCode がキーリングの検出に失敗します。gnome-keyring を使用している場合、以下の設定を追加することで VSCode に gnome-keyring を強制的に使用させることができます:
  +
  +
{{hc|~/.vscode-oss/argv.json|2=
  +
{
  +
...
  +
"password-store": "gnome",
  +
}
  +
}}
  +
  +
上記の設定ファイルのパスは {{pkg|code}} パッケージの場合です。別の VSCode フレーバを使用している場合は、{{ic|.vscode-oss}} の部分を書き換える必要があります。
  +
  +
{{TranslationStatus|Visual Studio Code|2023-10-05|787498}}

2023年10月5日 (木) 23:30時点における最新版

Code とは、Microsoft によって開発されているクロスプラットフォームのテキストエディタで、Electron フレームワーク上でビルドされています。Visual Studio Code は、MIT ライセンス Code - OSS リポジトリの1つのバイナリディストリビューションで、Microsoft 特有のカスタマイズがなされており、プロプライエタリライセンスのもとでリリースされています。この混合ライセンスに関する詳細は、この GitHub コメントを見てください。また、MIT ライセンスの VSCodium というバイナリリリースもあり、これはコミュニティで運営されていて、テレメトリ がデフォルトで無効化されています。

インストール

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

  • Code - OSS — 公式の Arch Linux オープンソースリリース。Open VSX を有効化する設定が同梱されています。
https://github.com/microsoft/vscode || code
  • Visual Studio Code — プロプライエタリな Microsoft ブランドのリリース。
https://code.visualstudio.com/ || visual-studio-code-binAUR
  • VSCodium — コミュニティのオープンソースリリース。ソースコード内でテレメトリが無効化されており [1]、Open VSX の設定も同梱されています。
https://vscodium.com/ || vscodiumAUR

これらの異なるフレーバはすべて 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 ビルドは、利用規約で定められている "対象範囲内の製品およびサービス" に含まれないと合理的に結論づけることができます。つまり、この行為は marketplace によって許可されていません。FS#67780 も参照してください。

既知の回避策は:

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

使用方法

code を実行して、アプリケーションを起動します (または、他のリリースを使用している場合、code-gitAUR は code-git を、vscodium-binAUR/vscodiumAUR/vscodium-gitAUR は codium を実行します)。

何らかの理由で Visual Studio Code の複数のインスタンスを起動した場合、-n フラグを使用できます。

設定

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

visual-studio-code-binAUR は設定を ~/.config/Code/User/settings.json に保存します。

vscodiumAUR や関連するパッケージは設定を ~/.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": "Your alternative terminal" で実行デバッグのときに使用するデフォルトのターミナルを設定します。

例: 

~/.config/Code/User/settings.json
"terminal.external.linuxExec": "gnome-terminal"

Wayland でネイティブに実行する

Visual Studio Code は Electron を使います。VSCode を Wayland 上でネイティブに動かす方法についての詳細は Wayland#Electron を見てください。しかし、一部のアプリケーションはシステムの electron を使用せず、独自のものを使用します。そのようなアプリケーションは標準の Electron フラグファイルを読み込みません。

ユーザ毎の設定ファイルを使用する場合、visual-studio-code-binAUR と code は両方 ~/.config/code-flags.conf を読み込みます。これらのパッケージは、これらのオプションを読み込むパッチを当てたローダスクリプトを使用するので、この挙動はこれらのパッケージ固有のものであることに注意してください。

vscodium-binAUR を使用する場合、~/.config/codium-flags.conf ファイルを使用してください。ターミナルから実行する場合、(vscodium ではなく) codium で実行してください。さもないと、ネイティブな Wayland ウィンドウが使用されません。

vscodiumAUR は設定ファイルを読み込みません (パッチを当てたローダスクリプトを使用しないからです)。

ネイティブなファイル選択ダイアログ

KDE を使用している場合、デフォルトでは VS Codium は GTK のファイル選択ダイアログを開きます。これを修正するには、環境変数 GTK_USE_PORTAL=1 を設定してください。

トラブルシューティング

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

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

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

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

例えば、trash-cli を使ってファイルを削除する場合: 

$ ELECTRON_TRASH=trash-cli code

本稿執筆時点で、Electron は kioclient5、kioclient、trash-cli、gio (デフォルト)、gvfs-trash (非推奨) をサポートしています。詳細はこちらの ドキュメントページ で確認できます。

C# をデバッグできない

C#.NET を (OmniSharp 拡張機能を使って) デバッグしたい場合、Microsoft ブランドの .NET リリースを (AUR から) インストールする必要があります。これは、.NET Core デバッガーが公式の Microsoft 製品でのみ使用できるようにライセンスされているからだと思われます。GitHub のディスカッションを見てください。

オープンソース版のパッケージを利用している場合は、デバッグは静かなメッセージで失敗します。デバッグコンソールは最初のメッセージが出力されるだけです: 

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.

オープンソース版のパッケージでデバッグする場合、netcoredbgAUR を利用できます。VS Code で実行するには、以下の設定をこのプロジェクトの .NET Core launch 設定に追加してください: 

./.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

MSBuild が見つからないと OmniSharp でエラーが発生する

OmniSharp introduction で説明されている通り、Arch Linux ユーザは mono-msbuild パッケージをインストールする必要があります。それがないと、以下のようなエラーが発生するかもしれません: 

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.
...

もしかするとビルドできるかもしれません (おそらく、mono がインストールされているかどうかにも依存しているのでしょう)

Omnisharp には独自の mono バージョンが同梱されています。Omnisharp がインストール済みの mono を見つけられない場合で、マシンにインストールされている "グローバルな" mono を検索するよう omnisharp を設定したい場合、以下を settings.json に追加してください: 

settings.json
"omnisharp.useGlobalMono:"always"

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

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

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

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

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

Microsoft ブランドのリリースでは、拡張機能によってアクセスされる提案された特定の API の使用を許可されている拡張機能が product.json ファイルにリストアップされています。Code - OSS と VSCodium にはこれらの値が存在しません (しかし、これはライセンスの問題というわけではないようです)。Marketplace の強制的な有効化とは異なり、以下の回避策は Microsoft によって推奨されています [3]。

この問題は、パッケージアップデートの時にそのファイルにパッチを当てる Pacman フックを導入することで解決できます:

また、関連するエントリを product.json ファイルの extensionAllowedProposedApi セクションに手動で追加することもできます:

  • code の場合、/usr/lib/code/product.json を編集してください
  • vscodiumAUR の場合、/usr/share/vscodium/resources/app/product.json を編集してください
  • vscodium-binAUR の場合、/opt/vscodium-bin/resources/app/product.json を編集してください

Live Share を機能させる手動設定の例は [4]: 

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

最後に、GitHub のプルリクエスト拡張で説明されているように、コマンドラインフラグを使ってこれらのオプションを有効化することもできます。

VS Live Share で API が欠けている

product.json を編集して上記の解決策を試すか、以下のオプションで VS Code を開いてください: 

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

また、この拡張機能を機能させるには、[5] にリストアップされている依存関係をインストールする必要があります。

Command 'remote-containers.openFolder' not found

FS#63374 でコメントされているように、remote-containers API を有効化して VS Code を開いてください: 

$ 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 エージェントを使用できないため発生します。バグレポートを見てください。この問題は、SSH 鍵#x11-ssh-askpass のようなダイアログプロバイダか、代替品 (例えば、KDE の ksshaskpass) をインストールすることで解決できます。

注意点としては、ksshaskpass の場合、/usr/lib/ssh/ssh-askpass からリンクを貼って VSCode がそれを見つけられるようにする必要があります: 

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

または、以下の環境変数をシェルで設定してください ([6] を参照): 

GIT_ASKPASS=ksshaskpass
SSH_ASKPASS=ksshaskpass
SSH_ASKPASS_REQUIRE=prefer

VSCode の内部 git-askpass を無効化するには、以下を追加してください: 

~/.config/Code - OSS/User/settings.json
{
    "git.useIntegratedAskPass": false
}

統合ターミナルで文字が切れる

幅が大きすぎる文字は、切れてしまう場合があります。例えば、Deno stack-traces のイタリック太文字テキストなどです。

この問題は、"terminal.integrated.rendererType" を "experimentalWebgl" に設定することで回避できます。

Wayland でテキストがぼやける

Visual Studio Code はデフォルトで Xwayland 下で実行されます。そのせいで、HiDPI スクリーンを使用している場合にテキストがぼやける場合があります。この問題を修正するには、Electron を Wayland 下で実行するように強制してみてください。#Wayland でネイティブに実行する を見てください。

あるいは、あなたの Wayland 環境が Xwayland アプリケーションをスケーリングせずに実行するオプションを提供している場合、この問題を回避できます。この場合、Visual Studio Code を --force-device-scale-factor= オプション付きで実行して画面に合う適切なスケールを使用してください。

例えば、スケールファクタ 2 の場合は: 

$ code --force-device-scale-factor=2

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 のようなキーリングをインストールするか、新しいキーリングを作成してください。

An OS keyring couldn't be identified

i3 などの一部のデスクトップ環境では、VSCode がキーリングの検出に失敗します。gnome-keyring を使用している場合、以下の設定を追加することで VSCode に gnome-keyring を強制的に使用させることができます: 

~/.vscode-oss/argv.json
{
    ...
    "password-store": "gnome",
}

上記の設定ファイルのパスは code パッケージの場合です。別の VSCode フレーバを使用している場合は、.vscode-oss の部分を書き換える必要があります。

翻訳ステータス: このページは en:Visual Studio Code の翻訳バージョンです。最後の翻訳日は 2023-10-05 です。もし英語版に 変更 があれば、翻訳の同期を手伝うことができます。
「https://wiki.archlinux.jp/index.php?title=Visual_Studio_Code&oldid=34182」から取得