Windows のローカルファイルと旧 WSL プロジェクト

Windows のプロジェクトフォルダーを開き、保存済みファイルを移動する際は旧 WSL プロジェクトを保持します。

Windows 版 Digital Design Studio 2.1.2.3 では、このPC → このPCのプロジェクト → プロジェクトフォルダーを開く からこの PC に保存されたフォルダーを開きます。以下の旧 WSL セクションでは、以前のインストール環境での復旧について説明します。検証済みのコピーを準備する間は、元のディストリビューションと保存済みファイルを保持してください。

既存プロジェクトを保持して移行する

復旧と検証済みのエクスポート・コピーが完了するまで、元のディストリビューション、ファイル、Git データ、未保存の作業を保持してください。ハッシュ、大文字と小文字を区別する名前、衝突、リンク、移動先の所有者を確認します。未解決のトランザクションは、元の所有者が復旧する必要があります。Linux の inode・UID 識別情報、ライセンス・デバイスの信頼、署名済み実行の適合確認、トランザクションジャーナルは、Windows や Cloud の権限にはなりません。ディストリビューションを削除したり、WSL パスを知らせずに Windows ルートとして開いたりしないでください。

旧方式:正しいプロジェクトの場所を選ぶ

WSL プロジェクトは、ソースと Linux エンジンの作業を、選択したディストリビューションの Linux ファイルシステム内に保持します。Windows アプリはウィンドウ、エディター、接続を提供します。Windows ローカルプロジェクトは別のアダプターを使用します。編集前に、ホストを意識して選択してください。

root ではない既定ユーザーを持つ、既存の x86-64 Ubuntu 24.04 WSL2 ディストリビューションを使用します。プロジェクトは Linux ユーザーのディレクトリ内、例えば /home/your-user/projects/demo に置いてください。/mnt/c やネットワーク共有は、この Linux ワークスペースの契約を満たしません。

旧方式:確認して接続する

PowerShell

wsl --list --verbose
  1. 目的のディストリビューションが WSL バージョン 2 として一覧に表示されることを確認します。アプリのプロジェクト接続は、ディストリビューションをインストールしません。

  2. Windows アプリから、例えば \\wsl.localhost\Ubuntu-24.04\home\your-user\projects\demo のような WSL プロジェクトパスを使って Linux プロジェクトを選択します。

  3. インストール済みアプリがバックエンドの準備を提供する場合は、その内容を確認し、対応する同梱バックエンドを使用してください。手動で差し替えたヘルパーは、互換性がない場合があります。

  4. ディストリビューション、ユーザー、プロジェクトルート、接続状態を確認します。トランザクションやエンジン実行の前に、小さいテキストファイルを 1 つ開いて保存してください。

旧方式:ファイル、Git、エンジン

保存済みテキスト、プロジェクト設定、対応するソース管理操作は、Linux ワークスペースを通じて実行されます。ファイルの書き込みでは保存済みリビジョンを確認します。WSL をバックエンドとする Git の読み取り・編集は、そのプロジェクトの Linux Git を使用します。ワークスペースに接続しても、すべてのエンジン、バイナリビューアー、リモート Git 転送が有効になるわけではありません。インストール済みホストに表示される操作を確認してください。

旧方式:変更後に再接続する

変更またはメッセージ

復旧方法

WSL が再起動した

未保存のテキストを保持し、明示的に再接続して、保存前にファイルを読み直す。

プロジェクトディレクトリが移動または置換された

目的のディレクトリを開き直す。新しいフォルダーの識別情報に古い接続を再利用しない。

root ユーザー、共有権限、Windows マウントが拒否された

目的の非 root ユーザーで、ユーザーが所有する Linux フォルダーを選択する。

保存の結果が不確か

書き込みを繰り返す前に、再読み込みして現在の保存済み内容を確認する。

パッケージ、バックアップ、エラー報告の手順については、Windows のインストール、ローカルワークスペース、診断を参照してください。

環境サポート

Use a Windows folder

  1. このPC → このPCのプロジェクト → プロジェクトフォルダーを開く を選択します。プロジェクト用の通常の Windows フォルダーを選択します。このホストは WSL パスを開きません。

  2. プロジェクトルートを確認し、ソースに無害な変更を保存して、再度開きます。ローカル Git などの Free ローカルツールはサインインなしで機能します。AI・Cloud・リモート Git・アカウントサービスにはサインインしてください。My PC にはデバイスライセンスは必要ありません。

  3. 以前の WSL の手順は、その接続を公開する古いアプリを対象としています。ファイルをコピーする前に、そこで元のプロジェクトを復旧して確認してください。元のディストリビューションを保持し、認証情報やトランザクションログを承認としてコピーしないでください。