GitHub Codespaces の個人用設定オプションのトラブルシューティング

ドットファイルと [設定の同期] に関する一般的な問題のトラブルシューティング手順。

この記事の内容

GitHub Enterprise Cloud の dotfiles リポジトリを使うか、Settings Sync を使って、GitHub Codespaces をカスタマイズできます。詳しくは、「アカウントの GitHub Codespaces をパーソナライズする」をご覧ください。

ドットファイルのトラブルシューティング

Codespace によるドットファイルからの構成設定の取得が失敗した場合は、次のデバッグ手順を実行する必要があります。

  1. 個人の GitHub Codespaces 設定で [ドットファイルを自動的にインストールする] を選んで、ドットファイルを有効にします。

    codespace 設定の [ドットファイル] セクションのスクリーンショット。[ドットファイルの自動インストール] オプションがオフです。

  2. ドットファイルが複製されているかどうかを確認するには、/workspaces/.codespaces/.persistedshare/dotfiles をチェックしてください。

    • ドットファイルが複製されている場合は、インストール スクリプトを手動で再実行して、それが実行可能であることを確認してください。
    • ドットファイルが複製されていない場合は、複製で問題が発生していたかどうかを確認するために、/workspaces/.codespaces/.persistedshare/EnvironmentLog.txt をチェックしてください。

  3. 考えられる問題について、/workspaces/.codespaces/.persistedshare/creation.log をチェックしてください。 詳細については、「作成ログ」を参照してください。

ドットファイルの構成が正常に取得されたものの、構成の一部に codespace との互換性がない場合は、$CODESPACES 環境変数を使用して、codespace 固有の構成設定の条件付きロジックを追加します。 codespaces と互換性がない可能性がある構成の詳細については、次を参照してください。

[設定の同期] のトラブルシューティング

Settings Sync をオフにすると、VS Code のインスタンスとの間で設定の同期を停止できます。

codespace で Settings Sync をオフにすると、新しい codespace では、前回クラウドにプッシュされたときにキャッシュされた設定が引き続き使用されます。 codespace に VS Code Web クライアントを使っていて、codespace がキャッシュされた設定の代わりに既定の設定を使うようにする場合、Settings Sync を無効にすることができます。詳細については、「Settings Sync のユーザー設定の管理」を参照してください。

デスクトップ アプリケーションを含む VS Code のすべてのインスタンスで既定の VS Code 設定を使うように戻したい場合は、Settings Sync をオフにするとクラウドのキャッシュをクリアできます。

  1. Settings Sync が VS Code のインスタンスで現在オフになっていて、キャッシュされた設定をクリアする場合、最初にオンにする必要があります。 手順については、「アカウントの GitHub Codespaces をパーソナライズする」を参照してください。

  2. アクティビティ バーの下部にある を選び、 [設定の同期がオン] をクリックします。

  3. ドロップダウンで、 [設定の同期: オフにする] をクリックします。

    ドロップダウン メニューのスクリーンショット。[設定の同期: オフにする] オプションが濃いオレンジ色の枠線で強調表示されています。

  4. キャッシュされた設定をクリアするには、ダイアログで [すべてのデバイスで同期を無効にして、クラウドからデータをクリアする] を選びます。

    [同期をオフにしますか?] ダイアログのスクリーンショット。 クラウドのデータを消去するオプションが選択されています。

  5. [オフにする] をクリックします。