如何将Mac上的DDEV Craft CMS项目迁移至PC并解决启动异常？

从错误输出看，核心问题是Docker未正确挂载项目的.ddev目录（提示/mnt/ddev_config/nginx_full/nginx-site.conf不存在），加上跨系统迁移可能遗漏的配置/数据同步，导致站点404。按以下步骤排查修复：

• 确保项目存放在PC用户目录下
  Windows系统中，Rancher Desktop对非用户目录的挂载支持有限，必须把项目放在C:\Users\<你的用户名>路径下，避免权限或挂载失败问题。

• 检查Rancher Desktop文件共享权限
  打开Rancher Desktop，进入Settings > Volumes，确认C:\Users目录已被勾选允许共享，未勾选的话勾选后重启Rancher Desktop。

• 重新初始化DDEV项目配置
  进入项目根目录，执行以下命令重新生成适配Windows的配置：

  ddev config
  

  选择craftcms项目类型，确认项目名称、文档根目录（Craft默认是web），其余保持默认即可。

• 重置DDEV容器与挂载
  先清理现有无效容器和挂载资源：

  ddev stop -a
  ddev delete -O
  

  再重新启动项目：

  ddev start
  

• 导入Mac端的数据库
  Git不会同步数据库文件，需手动迁移：

  1. 在Mac端项目执行导出：ddev export-db --file=db.sql
  2. 将db.sql传输到PC端项目根目录
  3. 在PC端执行导入：ddev import-db --file=db.sql

• 验证Nginx配置与文档根目录

  1. 检查.ddev/config.yaml中的docroot字段是否为web（Craft默认值），若自定义过需保持和Mac端一致
  2. 如果之前修改过Nginx配置，确保.ddev/nginx_full/nginx-site.conf文件已同步到Git，若缺失则从Mac端复制或重新创建

内容的提问来源于stack exchange，提问作者Haydentech