Windows 本地文件与旧版 WSL 项目

打开 Windows 项目文件夹,并在迁移已保存的文件时保留旧版 WSL 项目。

在 Windows 版 Digital Design Studio 2.1.2.3 中,通过本地 → 此电脑上的项目 → 打开项目文件夹打开存储在此电脑上的文件夹。下方的旧版 WSL 部分介绍了在旧安装环境中的恢复方法。准备经过验证的副本时,请保留原始发行版和已保存的文件。

保留与迁移现有项目

在恢复和经过验证的导出/复制完成之前,保留原始发行版、文件、Git 数据和未保存的工作。检查哈希值、区分大小写的名称、名称冲突、链接及目标所有权。未解决的事务必须由原所有者恢复。Linux inode/UID 身份、许可证/设备信任、签名执行资格和事务日志,不构成 Windows 或 Cloud 权限依据。不要删除发行版,也不要静默将 WSL 路径作为 Windows 根目录打开。

旧版:选择正确的项目位置

WSL 项目将源文件和 Linux 引擎工作保存在选定发行版的 Linux 文件系统中。Windows 应用提供窗口、编辑器和连接。Windows 本地项目使用不同的适配器;编辑前请有意选择宿主。

使用现有 x86-64 Ubuntu 24.04 WSL2 发行版,默认用户必须为非 root 用户。将项目放在 Linux 用户目录下,例如 /home/your-user/projects/demo。/mnt/c 和网络共享不符合此 Linux 工作区契约。

旧版:检查与连接

Powershell

wsl --list --verbose
  1. 确认目标发行版列出的 WSL 版本为 2。应用的项目连接不会安装发行版。

  2. 在 Windows 应用中,通过 WSL 项目路径选择 Linux 项目,例如 \\wsl.localhost\Ubuntu-24.04\home\your-user\projects\demo。

  3. 如果已安装应用提供后端准备功能,请检查并使用匹配的捆绑后端。手动替换的辅助工具可能不兼容。

  4. 确认发行版、用户、项目根目录和连接状态。执行事务或运行引擎之前,先打开并保存一个小型文本文件。

旧版:文件、Git 与引擎

已保存文本、项目设置及受支持的 Source Control 操作通过 Linux 工作区运行。文件写入会检查已保存修订。WSL 支持的 Git 读取和编辑使用该项目的 Linux Git。工作区已连接不意味着启用所有引擎、二进制查看器或远程 Git 传输;请检查已安装宿主显示的操作。

旧版:变更后重新连接

变更或消息

恢复方法

WSL 已重启

保留未保存文本,明确重新连接,并在保存前重新读取文件。

项目目录被移动或替换

重新打开目标目录;不要将旧连接复用于具有新文件夹身份的目录。

root 用户、共享权限或 Windows 挂载被拒绝

使用预期的非 root 用户,选择由该用户拥有的 Linux 文件夹。

保存结果不确定

重复写入之前,重新加载并检查当前已保存内容。

有关软件包、备份和错误报告步骤,请参阅 Windows 安装、本地工作区和诊断。

环境支持

Use a Windows folder

  1. 选择 本地 → 此电脑上的项目 → 打开项目文件夹。选择适用于项目的普通 Windows 文件夹。此主机不会打开 WSL 路径。

  2. 确认项目根目录,保存对源代码的无害更改,然后重新打开。本地 Git 等 Free 本地工具无需登录即可使用;使用 AI、Cloud、远程 Git 和账户服务时请登录。My PC 不需要设备许可证。

  3. 先前的 WSL 步骤适用于公开该连接的较旧应用程序。在复制文件之前,请先在该处恢复并验证原始项目;保留原始发行版,且勿复制凭据或事务日志作为授权。