Visual Studio Codeでは、ほとんどのタスクをキーボードから直接実行することが可能です。このページでは、デフォルトのバインディング(キーボードショートカット)とその更新方法を説明します。

Note: このページではアクセスしたプラットフォームのキーを表示します。他のプラットフォームを表示したい場合はマウスホバーしてください。

エディターのキーボードショートカット

Visual Studio Codeはキーボードショートカットエディターを使用して、豊富で簡単なキーボードショートカットの編集ができます。これはキーバインドの有無にかかわらず使用可能なすべてのコマンドを一覧表示して、使用可能なアクションを使用してキーバインドを簡単に変更/削除/リセットできます。また上部には、コマンドやキーバインドの検索に役立つ検索窓があります。 ファイル(Code) > 基本設定 > キーボード ショートカットに移動してキーボードショートカットを構成します。

ここで最も重要なのは、キーボードレイアウトに合わせてキーバインドを確認できることです。例えばドイツ語に変更された場合、USレイアウトで表されるcmd+\キーはctrl+shift+alt+cmd+7と表します。キーバインドを入力するダイアログでは、キーボードレイアウトごとに正しいキーボードバインドを割り当てます。

より高度なキーボードショートカットのカスタマイズをするにはAdvanced Customizationsを参照してください。

キーマップの拡張機能

キーボード ショートカットは生産性にとって不可欠です。ですがキーボードの習慣を変えるのは難しいものです。この問題に対処するために ファイル > 基本設定 > キーマップ拡張機能では、一般的なキーマップ拡張機能のリストを用意しています。これら拡張機能は、VS Codeのショートカットを他のエディタのショートカットと一致するように変更できるので、新しいキーボードショートカットを習得する必要はありません。MarketplaceでKeymaps category をより詳細に確認してください。

キーボード ショートカットの参照

印刷可能なキーボードショートカットリストを用意しています。ヘルプ > キーボード ショートカットの参照で印刷に最適化されたPDFバージョンを表示します。

各プラットホーム別のリンクは次の通りです:

• Windows
• macOS
• Linux

キーバインドの競合の検出

多くの拡張機能がインストールされている場合や、ショートカットのカスタマイズをしている場合に、同じキーボードショートカットへ複数のコマンドをマッピングしていると、競合が発生することがあります。これにより特にエディターの移動で異なるキーバインドが実行され、混乱を招く可能性があります。

キーボードショートカットエディターには、ショートカットの競合をフィルターして表示するコンテキストメニューの競合の表示があります。

多重に定義されていると思うキーバインドを使用するコマンドを選択して、複数のコマンドが定義されているかどうか、キーバインドのソース、いつアクティブになるかを確認できます。

Default Keyboard Shortcuts

Note: 次のキーは標準のUSキーボードを想定してレンタリングしています。異なったキーボードレイアウトを使用する場合はここを参照してください。現在アクティブなキーボードショートカットはVS Code内(コマンドパレット (表示 -> コマンドパレット)かキーボードショートカットエディター(ファイル > 基本設定 > キーボードショートカット))で表示することができます。

基本編集

(※VS Code i18nから引用し対応していない場合英文のままです

言語編集

ナビゲーション

エディター/ウィンドウ管理

ファイル管理

表示

基本設定

デバッグ

タスク

拡張機能

高度なカスタマイズ

VS Code内すべてのキーボードショートカットはkeybindings.jsonファイルでカスタマイズすることができます。

• キーボードショートカットをで設定するには、Keyboard Shortcutsエディターを開き、keybindings.jsonをクリックします。
• これにより、左側に既定のキーバインドと右側にkeybindings.jsonファイルを開きます。右側のファイルで既定のキーバインド設定を上書きできます 。
• なお上記のリストは完全なものではありません。既定のキーボードショートカット下の”Here are other available commands”でより多くを確認できます。

キーボードのルール

キーボードショートカットの割り当ては、JSONによるルールのリストを分析することによって行われます。いくつかの例を次に示します:

// Keybindings that are active when the focus is in the editor
{ "key": "home",            "command": "cursorHome",                  "when": "editorTextFocus" },
{ "key": "shift+home",      "command": "cursorHomeSelect",            "when": "editorTextFocus" },
// Keybindings that are complementary
{ "key": "f5",              "command": "workbench.action.debug.continue", "when": "inDebugMode" },
{ "key": "f5",              "command": "workbench.action.debug.start",    "when": "!inDebugMode" },
// Global keybindings
{ "key": "ctrl+f",          "command": "actions.find" },
{ "key": "alt+left",        "command": "workbench.action.navigateBack" },
{ "key": "alt+right",       "command": "workbench.action.navigateForward" },
// Global keybindings using chords (two separate keypress actions)
{ "key": "ctrl+k enter",    "command": "workbench.action.keepEditor" },
{ "key": "ctrl+k ctrl+w",   "command": "workbench.action.closeAllEditors" },

各ルールは次の通りです:

• key : 押されるキー
• command : 実行するコマンドID
• when(オプション) : 現在のコンテキストに応じて評価されるブール式を含める値

Chord(別個のキー操作)は、2つのキーをスペースで区切って記述します。E.g.: ctrl+k ctrl+c。

キーが押されたとき:

• ルールは下から上に評価します。
• keyとwhenが条件に一致した最初のルールを利用します。
• それ以降のルールは処理しません。
• ルールが一致したうえでcommandをセットしていれば、そのcommandを実行します。

追加のkeybindings.jsonルールは実行時に既定ルールの最後に追加され、既定のルールを上書きします。keybindings.jsonファイルはVS Codeで監視するので、実行中でもルールを更新できます。

利用可能なキー

keyは修飾子とキーで構成します。

次の修飾子を受け付けます:

次のキーを受け付けます:

• f1-f19, a-z, 0-9
• `, -, =, [, ], \, ;, ', ,, ., /
• left, up, right, down, pageup, pagedown, end, home
• tab, enter, escape, space, backspace, delete
• pausebreak, capslock, insert
• numpad0-numpad9, numpad_multiply, numpad_add, nupad_separator
• numpad_subtract, numpad_decimal, numpad_divide

コマンドの引数

引数を指定してコマンドを呼びだすことができます。多くの場合、特定のファイルやフォルダー上で同じ操作を実行する場合に便利です。

既存のEnterキーを上書きする例です：

{ "key": "enter", "command": "type",
                  "args": { "text": "Hello World" },
                  "when": "editorTextFocus" }

“command”: “type” により、Enterキーが入力されると {“text”： “Hello World”} を最初の引数として受け取り、”Hello World” をエディターに出力する動作となります。

when節のコンテキスト

VS Codeはオプションのwhen節を通して、キーバインディングの有効タイミングを細かく制御できます。なおwhenを設定していないキーバインディングは常に利用可能です。

次はtrue/falseのブーリアン式で評価可能なwhen節のコンテキスト例です:

Note: 任意のユーザーまたはワークスペース設定で接頭辞"config."を持つブール値を使用できます。

上記のリストは完全なものではありません。既定のキーボードショートカットでwhenコンテキストを確認してください。

特定のキーバインド ルールを削除

既定のキーバインドを削除するキーバインド ルールを記述できます。keybindings.jsonではVS Codeのすべてのキーバインドを再定義することが可能です。ですがTabやEscapeといったキーの一部を微調整をするには向きません。特定のキーバインディングを削除するにはcommandに-を追加します。これによりルールは削除ルールにかわります。

例を次に示します:

// In Default Keyboard Shortcuts
...
{ "key": "tab", "command": "tab", "when": ... },
{ "key": "tab", "command": "editor.emmet.action.expandAbbreviation", "when": ... },
{ "key": "tab", "command": "jumpToNextSnippetPlaceholder", "when": ... },
{ "key": "tab", "command": "acceptSelectedSuggestion", "when": ... },
...
// To remove the second rule, for example, add in keybindings.json:
{ "key": "tab", "command": "-editor.emmet.action.expandAbbreviation" }

キーボードレイアウト

Note: このセクションはキーバインディングにのみ関連し、エディタでの入力には関係しません。

上記のキー(印刷文字?)は仮想キーの文字列表現であり、押したときに入力される文字と必ずしも関連しません。詳細:

• 参考: Virtual-Key Codes (Windows)
• tab for VK_TAB (0x09)
• ; for VK_OEM_1 (0xBA)
• = for VK_OEM_PLUS (0xBB)
• , for VK_OEM_COMMA (0xBC)
• - for VK_OEM_MINUS (0xBD)
• . for VK_OEM_PERIOD (0xBE)
• / for VK_OEM_2 (0xBF)
• ` for VK_OEM_3 (0xC0)
• [ for VK_OEM_4 (0xDB)
• \ for VK_OEM_5 (0xDC)
• ] for VK_OEM_6 (0xDD)
• ' for VK_OEM_7 (0xDE)
• etc.

異なったキーボードレイアウトを使用すると、上記の仮想キーの位置が変わっていたり押したときに挿入する文字が異なったりします。異なるキーボードレイアウトを使用する場合、Visual Studio Codeは次の処理を行います:

すべてのキーバインディングは、現在のシステムのキーボードレイアウトを使用してUIに表示します。たとえば、フランス語のキーボードレイアウトを使用しているときの Split EditorはCtrl+*としてレンダリングします:

keybindings.jsonを編集するとき、VS Codeは標準のUSキーボードレイアウトで生成された文字で表現します。現在のシステムキーボードレイアウトで異なる印字のキーを押す必要がある場合はそのキーバインディングを強調表示します。たとえばフランスのキーボードレイアウトを使用するときの既定のキーバインドルールは次のようになります:

またkeybindings.jsonを編集するときにキーバインドルール追加を助けるウィジェットがあります。このウィジェットを起動するには、 ⌘K ⌘K (Windows, Linux Ctrl+K Ctrl+K)を押します。ウィジェットは、VSのコードは、現在のキーボードレイアウトの下で検出されたキーをキーの押下を待機し、テキストボックスに、それ以下のシリアル化されたJSON表現をレンダリングします。キーの組み合わせを入力しおえたらEnterを押してルールを挿入します。

Note: Visual Studio Codeは起動時に現在のキーボードレイアウトを検出して、この情報をキャッシュします。ですからキーボードレイアウトを変更した場合は、VS Codeの再起動をお勧めします。

次のステップ

今回キーバインドサポートについて確認できました。次は何を…

• Language Support - Our Good, Better, Best language grid to see what you can expect
• Debugging - This is where VS Code really shines
• Node.js - End to end Node.js scenario with a sample app

よくある質問

Q: どのコマンドがキーにバインドされているかを調べるにはどうすればいいですか？

A: 既定のキーボードショートカットで⇧⌘O (Windows, Linux Ctrl+Shift+O)
を押して Quick Outlineを開きます。

Q: 行を削除するCtrl+Dのようなアクションをキーバインドに追加するにはどうすればいいですか？

A: 既定のキーボード ショートカットのアクションをトリガするルールを見つけて、keybindings.jsonファイルに変更したバージョンを書きます:

// Original, in Default Keyboard Shortcuts
{ "key": "ctrl+shift+k",          "command": "editor.action.deleteLines",
                                     "when": "editorTextFocus" },
// Modified, in User/keybindings.json, Ctrl+D now will also trigger this action
{ "key": "ctrl+d",                "command": "editor.action.deleteLines",
                                     "when": "editorTextFocus" },

Q: どのようにして特定ファイルタイプのキーバインドを追加できますか？

A: when節にeditorLangIdコンテキストキーを使用します:

{ "key": "shift+alt+a",           "command": "editor.action.blockComment",
                                     "when": "editorTextFocus && editorLangId == csharp" },

Q: キーバインディングをkeybindings.jsonで変更しましたが機能しません

A: 最もよくある問題はファイルの構文エラーです。 そうでなければ when節を削除するか、別のkeyを選んでみてください。残念ながら現時点では、このように試行錯誤するしかありません。