トラブルシューティング:VS Codeのショートカットキーが効かない原因と対処法

VS Codeのショートカットキーのトラブルシューティングをイメージした、キーボード・コードエディタ・設定アイコンが配置されたイラスト
VS Codeのショートカットキーが効かない原因と対処法を紹介する記事のアイキャッチ画像

Visual Studio Code(VS Code)は、多数のショートカットキーを活用することで、コーディングやファイル操作を効率化できるエディタです。しかし、「設定画面が開かない」「保存のショートカットが反応しない」「一部のキーだけ効かない」といったトラブルが発生することがあります。

ショートカットキーが効かない原因は、VS Code本体だけでなく、OSの設定やキーボードレイアウト、拡張機能などさまざまです。

この記事では、VS Codeのショートカットキーが効かない主な原因と、それぞれの対処方法をわかりやすく解説します。

ショートカットキーが効かない主な原因

VS Codeでショートカットキーが動作しない場合は、次のような原因が考えられます。

  • キーボードショートカットが変更されている
  • OSのショートカットと競合している
  • 拡張機能がショートカットを上書きしている
  • キーボードレイアウトが異なる
  • 入力モードやフォーカスが原因
  • VS CodeやOSの不具合

まずは原因を切り分けながら確認していくことが重要です。

キーボードショートカットが変更されている

VS Codeではショートカットキーを自由に変更できます。

意図せず変更してしまった場合や、拡張機能によって変更された場合は、本来のキーでは動作しません。

ショートカット一覧を確認する

以下の操作でショートカット一覧を開きます。

Windows・Linux

Ctrl + K → Ctrl + S

macOS

⌘ + K → ⌘ + S

検索欄からコマンド名を入力すると、現在割り当てられているキーを確認できます。

初期設定へ戻す

変更したショートカットは右クリックからReset Keybindingを選択すると初期状態へ戻せます。

問題が特定のショートカットだけであれば、この方法で解決するケースがあります。

OSのショートカットと競合している

VS CodeよりもOS側のショートカットが優先されることがあります。

例えば次のようなケースです。

  • Windowsのシステムショートカット
  • macOSのMission Control
  • 日本語入力ソフトのショートカット
  • グラフィックソフトやユーティリティソフト

VS Code側に問題がなくても、OSがキー入力を先に処理するとショートカットは動作しません。

Windowsの場合

Windowsでは以下を確認します。

  • Windowsのショートカット設定
  • PowerToys
  • AutoHotkey
  • キーボードメーカーの専用ソフト

これらがキーを割り当てている場合があります。

macOSの場合

macOSでは以下を確認します。

  • システム設定
  • キーボード
  • キーボードショートカット

Mission ControlやSpotlightなどと競合していないか確認します。

拡張機能がショートカットを変更している

VS Codeの拡張機能はショートカットキーを追加・変更できます。

特に以下のような拡張機能はショートカットを多く登録します。

  • Vim
  • Emacs
  • キーバインド拡張
  • Git関連拡張

拡張機能を無効化して確認する

一時的に拡張機能を無効化します。

  1. 拡張機能を開く
  2. 該当する拡張機能を無効化
  3. VS Codeを再起動

これで改善する場合は、その拡張機能が原因です。

キーボードレイアウトが異なる

日本語配列(JIS)と英語配列(US)ではキー配置が異なります。

例えば以下は入力位置が異なります。

  • @
  • :
  • ;
  • \
  • [ ]

そのため、ショートカットによっては期待どおりに動作しないことがあります。

キーボードレイアウトを確認する

Windowsでは

設定 → 時刻と言語 → 言語と地域

macOSでは

システム設定 → キーボード

から現在の入力ソースを確認できます。

フォーカスがVS Codeにない

ショートカットはVS Codeにフォーカスがある場合のみ動作します。

例えば

  • ターミナル
  • 検索ボックス
  • ダイアログ
  • 他のアプリ

にフォーカスがあると、一部のショートカットは無効になります。

まずVS Codeのエディタ部分をクリックしてから試してみましょう。

日本語入力(IME)が影響している

日本語入力中は一部ショートカットが反応しないことがあります。

特に変換候補が表示されている状態では、キー入力がIME側へ送られます。

その場合は

  • 日本語変換を終了する
  • 半角英数へ切り替える

ことで改善する場合があります。

設定ファイルが壊れている

設定ファイルに誤った内容が記述されていると、ショートカットが正常に動作しないことがあります。

代表的な設定ファイルは次の2つです。

  • settings.json
  • keybindings.json

編集後に問題が発生した場合は、バックアップから戻すか、不要な設定を削除して確認します。

セーフモードで確認する

VS Codeには拡張機能を読み込まず起動する方法があります。

ターミナルから以下を実行します。

code --disable-extensions

この状態でショートカットが動作する場合は、拡張機能が原因である可能性が高いと考えられます。

VS Codeを最新版へ更新する

古いバージョンではショートカット関連の不具合が修正されている場合があります。

更新手順は次のとおりです。

  1. Help(ヘルプ)
  2. Check for Updates
  3. 更新後に再起動

最新版へ更新して改善するケースも少なくありません。

OSを再起動する

一時的な入力デバイスの不具合でショートカットが効かなくなることがあります。

次の順番で確認すると効率的です。

  1. VS Codeを再起動
  2. キーボードを抜き差しする
  3. パソコンを再起動

意外にこの方法で解決するケースもあります。

よくあるショートカットが効かない例

Ctrl + , が効かない

設定画面を開くショートカットです。

確認するポイント

  • OSがショートカットを使用していないか
  • キーバインドが変更されていないか
  • キーボードレイアウトが異なっていないか

Ctrl + Shift + P が効かない

コマンドパレットを開くショートカットです。

動作しない場合は

  • 拡張機能
  • キーバインド
  • IME

を確認しましょう。

Ctrl + S が効かない

保存できない場合は

  • キーボード故障
  • ショートカット変更
  • OSの競合

を確認します。

メニューから保存できる場合は、ショートカット設定に原因がある可能性があります。

トラブルシューティングの確認手順

ショートカットキーが効かない場合は、次の順番で確認すると原因を特定しやすくなります。

  1. VS Codeを再起動する
  2. ショートカット設定を確認する
  3. 拡張機能を無効化する
  4. OSショートカットを確認する
  5. IMEをオフにする
  6. キーボードレイアウトを確認する
  7. code --disable-extensionsで起動する
  8. VS Codeを最新版へ更新する
  9. パソコンを再起動する

上から順番に確認することで、多くの問題は解決できます。

まとめ

VS Codeのショートカットキーが効かない原因は、キーバインドの変更だけではありません。

  • ショートカット設定
  • OSとの競合
  • 拡張機能
  • IME
  • キーボードレイアウト
  • 設定ファイル
  • VS Code本体

など、複数の要因が考えられます。

問題が発生した場合は、原因を一つずつ切り分けながら確認することが、最も確実な解決方法です。

関連記事