⌨️

VSCodeでワークスペースごとに独自のキーバインドを使う裏技

2024/03/09に公開

VS Code

開発環境

tech

はじめに

皆さんはVSCodeに独自のキーボードショートカット追加していますか?
よく使う小技的なものや、VSCodeのタスク機能を割り当ててコマンド実行をさせている方も多いんじゃないでしょうか。

VSCodeのキーボードショートカット作成はkeybinding.jsonを編集することで可能で、キーボードショートカットごとに発動条件を"When"で指定することができます。
例えば

keybinding.json

	{
	"key": "ctrl+shift+j",
	"command": "workbench.action.terminal.focus",
	"when": "editorTextFocus"
	},{
	"key": "ctrl+shift+j",
	"command": "workbench.action.focusFirstEditorGroup",
	"when": "terminalFocus"
	},

とすることで同じctrl+shift+jのショートカットを

エディター選択時はターミナルに移動
ターミナル選択時はエディターに移動

として使うことができます。
(話は逸れますが、このショートカットは個人的によく使うもので、ctrl+jのパネル表示/非表示との親和性が高いのでおすすめです)

whenの詳しい使い方については公式の解説を参照してください

ですがwhenでは対応できないこんなシチュエーションに遭遇したことはありませんか?

同じキーボードショートカットをワークスペースごとに意味を変えたい
押しやすいキーの組み合わせをワークスペースごとに意味を変えて使いたい
特定のワークスペースだけでしか使わないキーボードショートカットがある

これらはVSCodeではワークスペースごとにkeybinding.jsonを置くことができず、whenの機能ではワークスペースを識別できないために生じます。
そのため公式にはワークスペースごとに違ったキーボードショートカットを使うことはサポートされていないのですが、今回はこれを(あまりスマートではないが便利な)裏技で回避していきます。

やることの概要

やることとしては至ってシンプルです。
ワークスペースごとに定義できないのならばワークスペースごとにフラグを作成し、それを見てキーボードショートカットの有効無効を変えてやろうという作戦になります。

具体的には

ワークスペースの.vscode/setting.jsonのファイルでワークスペースに固有の設定値にTrueを入れる
keybinding.jsonの使いたいキーボードショートカットの"when"で1. で指定した設定値がTrueかどうかの確認をいれる

となります。
一つづつ見ていきましょう。

ワークスペースでの設定

ワークスペースの識別のために固有のフラグを作ります。

まず使いたいワークスペースを開き、VSCodeのワークスペースごとの設定情報を入れる.vscode/setting.jsonフォルダに移動します。(なければ作成してください)

次に中に次の１行を追加します。

setting.json

{
	"workspaceKeybindings.hogehoge_ws.enabled": true,
}

ここの"workspaceKeybindings.hogehoge_ws.enabled"は今適当に考えた名前で、VSCodeさんはこんな項目知らないので「不明な構成設定」とか言われてグレーアウトされますが、気にしなくて良いです。
名前もワークスペースごとにお好きなものに変えてください。

以上でワークスペース側での設定は終わりです。

keybinding.jsonでの設定

keybinding.jsonを編集して、ショートカットがワークスペース側で作ったフラグを判定できるようにします。

具体的には下記のようにします。フラグの名前はそれぞれのワークスペースでつけたものと合わせてください。

keybinding.json

	{
	"key": "ctrl+shift+q",
	"command": "command_1",
	"when": "workspaceKeybindings.hogehoge_ws.enabled",
	},
	{
	"key": "ctrl+shift+q",
	"command": "command_2",
	"when": "workspaceKeybindings.hugahuga_ws.enabled",
	},

↑のようにすると、同じctrl+shift+qのショートカットでworkspaceKeybindings.hogehoge_ws.enabledがTrueにしているワークスペースではcommand_1が、workspaceKeybindings.hugahuga_ws.enabledがTrueにしているワークスペースではcommand_2が実行されます。

おわり

以上のようにすることでワークスペースごとに独自のキーボードショートカットを使うことができます。
ワークスペースだけで完結できないのが玉に瑕ですが、かゆいところに手が届くようになる場合もあると思いますので、参考にしてご活用ください

はじめに

やることの概要

ワークスペースでの設定

keybinding.jsonでの設定

おわり

参考

Discussion