Troubleshooting and FAQ

Troubleshooting & FAQ

README の Common errors / doctor / FAQ 節をユーザーがまず検索する場所として独立させたページ。

Outline

doctor の読み方

• [OK] / [WARN] / [FAIL] の意味と終了コード
• チェック対象（WSL2, interop, WSLC, config, architecture, Git）
• Gitチェックが警告どまりである理由

よくあるエラー

• WSLC not found（auto の探索順、インストール/更新手順）
• Docker Hub authentication（wslc registry login の案内）
• bind mount時の起動遅延（症状・原因・Guidesへの誘導）
• CPU architecture mismatch（docker buildx imagetools inspect / buildx build --platform 例）

FAQ（README から転載・拡充）

• どのmodeから始めるべきか
• dependencies: と compose: は併用できるか
• compose と compose-native の違い
• dependencies: と compose-native は何が違うのか
• compose-native は wslc のCompose対応後どうなるか
• sync: は必須か
• bind mount問題をwipがどう解決するか
• wip.yml にパスワードを書いても安全か（マスキングと.envの使い分け）
• wslc.exe/wslc が見つからない場合
• dip移行時に interaction: をリネームする必要はあるか

ここに載っていない問題を報告する

• Issue報告時に含めるべき情報（CONTRIBUTING.md へのリンク: wip.yml、実行コマンドと出力、WIP_DEBUG=1出力、wip doctor出力、OS/WSL/WSLCバージョン）