Windows ターミナルでのトラブルシューティング

このガイドでは、Windows ターミナルの使用時に発生する可能性のある一般的なエラーと障害について説明します。

設定を開くと何も行われません (または、予期しないアプリケーションが開きます)

ドロップダウンで 設定 ボタンを選択すると、ターミナルは設定ファイルを開こうと settings.json。 この操作により、OS は構成済みの .json ファイル エディターを起動します。 このエディターは、Visual Studio、メモ帳、またはその他の予期しないアプリケーションである可能性があります。 コンピューターに .json エディターが構成されていない場合、OS には最終的に [このファイルを開く方法 ] ダイアログが表示されます。

以前のバージョンの Windows ターミナルで起動したときに、ホーム ~ ディレクトリから開始するように WSL ディストリビューションを設定する

既定では、プロファイルの startingDirectory は %USERPROFILE% (C:\Users\<YourUsername>) です。 このパスは Windows パスです。 新しいバージョンの Windows ターミナルを実行している WSL ディストリビューションの場合、ファイル システムは ~ を入力して、このホーム パスを設定できます。 以前のバージョンの Windows ターミナルでは、 /home/<Your Ubuntu Username> を使用してホーム フォルダーを直接参照できます。 たとえば、次の設定では、ホーム ファイル パスで "Ubuntu-20.04" ディストリビューションが起動します。

{
    "name": "Ubuntu-20.04",
    "commandline" : "wsl -d Ubuntu-20.04",
    "startingDirectory" : "/home/<Your Ubuntu Username>"
}

非常に初期のバージョンの Windows ターミナルを使用している場合、WSL では、\\wsl$\設定のディストリビューションのホーム パスを参照するときに、startingDirectory プレフィックスの使用が必要になる場合があります。 たとえば、次の設定では、ホーム ファイル パスで "Ubuntu-18.04" ディストリビューションが起動します。

{
    "name": "Ubuntu-18.04",
    "commandline" : "wsl -d Ubuntu-18.04",
    "startingDirectory" : "//wsl$/Ubuntu-18.04/home/<Your Ubuntu Username>"
}

タブ タイトルの設定

シェルでタブ タイトルを自動的に設定するには、 タブ タイトルの設定に関するチュートリアルを参照してください。 独自のタブ タイトルを設定する場合は、 settings.json ファイル を開き、次の手順に従います。

1. 任意のコマンド ラインのプロファイルで、シェルが送信するタイトル変更イベントを抑制する "suppressApplicationTitle": true を追加します。 この設定 のみを プロファイルに追加すると、タブ タイトルがプロファイルの名前に設定されます。

2. プロファイルの名前ではないカスタム タブ タイトルが必要な場合は、 "tabTitle": "TITLE"追加します。 "TITLE" を任意のタブ タイトルに置き換えます。

PowerShell のコマンド ライン引数

PowerShell でのコマンド ライン引数の動作については、「 コマンド ライン引数」ページを参照してください。

WSL のコマンド ライン引数

WSL でのコマンド ライン引数の動作については、「 コマンド ライン引数」ページを参照してください。

問題の設定 startingDirectory

プロファイルで startingDirectory 設定が無視される場合は、最初に settings.json ファイルの構文を確認します。 この構文を確認するために、 "$schema": "https://aka.ms/terminal-profiles-schema" が自動的に挿入されます。 Visual Studio Code などの一部のアプリケーションでは、その挿入されたスキーマを使用して、編集時に JSON ファイルを検証します。

設定が正しい場合は、ターミナルの開始ディレクトリを個別に設定するスタートアップ スクリプトを実行している可能性があります。 たとえば、PowerShell にはプロファイルの独自の概念があります。 PowerShell プロファイルで開始ディレクトリを変更した場合、Windows ターミナルで定義されている設定よりも優先されます。

または、 commandline プロファイル設定を使用してスクリプトを実行する場合は、そのスクリプト内の場所を設定している可能性があります。 PowerShell プロファイルと同様に、スクリプト内のコマンドは startingDirectory プロファイル設定よりも優先されます。

startingDirectoryの目的は、指定されたディレクトリで新しい Windows ターミナル インスタンスを起動することです。 ターミナルでディレクトリを変更するコードが実行されている場合は、そのコードを確認します。

Ctrl + = フォント サイズが大きくない

ドイツ語のキーボード レイアウトを使用すると、この問題が発生する可能性があります。 メイン キーボード レイアウトがドイツ語に設定されている場合、 Ctrl + = は Ctrl + Shift + 0 として逆シリアル化されます。 このマッピングは、ドイツ語のキーボードに適しています。

さらに重要なのは、アプリが Ctrl + Shift + 0 キーストロークを受け取らない点です。 この問題は、複数のキーボード レイアウトがアクティブな場合、 Windows によって Ctrl + Shift + 0 が予約されるために発生します。

Ctrl+=が正常に動作するようにこの機能を無効にする場合は、このブログ記事の「Windows 10 でホットキーを変更してキーボード レイアウトを切り替える」の手順に従ってください。

[キーボード レイアウトの切り替え] オプションを [未割り当て] (または Ctrl + Shift キーを押す) に変更し、[ OK] を 選択してから [適用] を選択します。 Ctrl + Shift + 0 がキー バインドとして機能し、ターミナルに渡されるようになりました。

一方、複数の入力言語に対してこのホットキー機能を使用する場合は、settings.json ファイルで独自のカスタム キー バインドを構成できます。

テキストがぼやけている

一部のディスプレイ ドライバーとハードウェアの組み合わせは、前のフレームのデータをぼかしることなくスクロール領域とダーティ領域を処理しません。 この問題を軽減するには、 これらのグローバル レンダリング設定 の組み合わせを追加して、ターミナル テキスト レンダラーによるハードウェアへの負担を軽減します。

私の色は奇妙に見えます! 私の画面上に黒いバーがあります!

Windows ターミナル 1.2 以降のバージョンでは、特定のアプリケーションの色設定の理解が向上しています。 この理解が向上したため、多くの互換性ブロックが削除され、ユーザー エクスペリエンスが低下しました。 残念ながら、少数のアプリケーションで問題が発生する可能性があります。

既知の問題とその回避策の一覧を最新状態に保つため、このトラブルシューティング項目を常に最新の情報に更新します。

PowerShell の黒い線 (5.1、6.x、7.0)

ターミナルは、PowerShell の行編集ライブラリ PSReadline と組み合わせて使用すると、画面全体に黒い線が描画される場合があります。 これらの誤った色の領域は、コマンド パラメーター、文字列、または演算子があるところではどこでも、画面上に広がります。

PSReadline バージョン 2.0.3 には、この問題の修正プログラムが含まれています。 プレリリース バージョンの PSReadline を使用している場合は、修正プログラムはまだ利用できないことに注意してください。

PSReadline の最新バージョンに更新するには、次のコマンドを実行します。

Update-Module PSReadline

絵文字がジャンプリストのアイコンとして表示されないのはなぜですか?

ジャンプリストにプロファイル アイコンとしてレンダリングできるのは、ファイルの場所からリンクされた画像だけです。 ジャンプリストでは、アイコンの絵文字はサポートされていません。

テクニカル ノート

GetConsoleScreenBufferInfo API ファミリを使用して、アクティブなコンソールの色を Win32 形式で取得し、クロスプラットフォーム VT シーケンスに変換しようとするアプリケーション (たとえば、BACKGROUND_REDを\x1b[41mに変換するなど) は、アプリケーションが使用しようとしている背景色を検出するターミナルの機能を妨げる可能性があります。

色を調整するには、Windows API 関数 または VT シーケンスのいずれかを選択します。 それらを混在させないでください。

キーボード サービスの警告

Windows ターミナル 1.5 以降では、"タッチ キーボードと手書きパネル サービス" が無効になっている場合、ターミナルに警告が表示されます。 オペレーティング システムでは、入力イベントをターミナル アプリケーション (および Windows 上の他の多くのアプリケーション) に適切にルーティングするために、このサービスが必要です。 この警告が表示された場合は、次の手順に従ってサービスを再度有効にします。

1. 実行ダイアログで、次を実行します。 services.msc

   

2. "タッチ キーボードと手書きパネル サービス" を見つける

   

3. このサービスの "プロパティ" を開きます

   

4. "スタートアップの種類" を "自動" に変更する

   

5. [ OK] を選択し、PC を再起動します。

マシンを再起動すると、サービスが自動的に開始され、ダイアログが表示されなくなります。

Git Bash コマンド ラインを使用しているときに画面が点滅するのはなぜですか?

Windows ターミナル内で Git Bash コマンドラインを使うと、点滅やちらつきが起こることがあります。 この動作は実際には仕様です。 ターミナルは、Git Bash の指示に従います ( bell-style を visibleに設定すると、フラッシュがベル応答に関連付けられます)。ただし、この動作は気が散る可能性があります。 この問題を解決するには、Git Bash の .inputrc ファイルをテキスト エディターで開きます。 このファイルは、パス C:\Program Files\Git\etcにある可能性があります。 Nano テキスト エディターでファイルを開くには、次のコマンドを使用します: nano ~/.inputrc。

既定値を変更します。

# none, visible or audible
set bell-style visible

bell-styleをnoneまたはaudibleに設定して、表示されているフラッシュを削除します。

set bell-style none

Ctrl + O キーと Ctrl + X キーを押して保存して終了します。

Windows ターミナルの設定を既定の設定にリセットするにはどうすればよいですか?

設定を元の既定の設定にリセットするには、 settings.json ファイルを削除します。 この操作により、Windows ターミナルは、元の既定の設定で settings.json ファイルを再生成します。

アクリルの不透明度が Windows ターミナルの背景を透明にしないのはなぜですか?

ターミナル ウィンドウの透明度は、useAcrylic プロパティを使用して設定できます。 アクリルでは不透明度の設定が機能しない理由がいくつかあります。次に例を示します。

• システム全体のポリシーとして、アクリルはフォアグラウンド ウィンドウに対してのみ有効になります。 ターミナル以外のウィンドウをアクティブにすると、ターミナルのアクリルがオフになります。
• お使いの GPU ハードウェアでサポートされていない場合、アクリルは機能しません。 仮想マシン (VM) またはリモート デスクトップ経由でアプリを実行している場合、アクリルは機能しない可能性があります。
• オペレーティング システムでは、電源セーバー (バッテリ残量不足) モードであることや、リモート デスクトップを使用してコンピューターにアクセスする場合など、さまざまな理由でアクリルが無効になります。

ウィンドウの上にマウス ポインターを置いて入力を開始すると、マウス ポインターが消えるのはなぜですか?

このカーソルの自動非表示動作は仕様に応じて行われますが、無効にすることもできます。 Windows 設定でマウスの設定を検索し>マウスの追加設定>マウスのプロパティ>Pointer のオプション>入力中にポインターを非表示にするをオフにします。 この変更を有効にするには、Windows ターミナルの再起動が必要になる場合があります。