用途：为 Drupal 项目提供 DDEV 本地开发环境的使用模式与排错参考，覆盖环境搭建、配置、日常流程与性能调优。
主要能力：ddev start/stop/restart/ssh/logs/describe/launch 等基础命令；通过 ddev drush 与 ddev composer 执行 Drush 和 Composer；数据库操作（ddev import-db --file=backup.sql.gz、ddev export-db、ddev snapshot）；.ddev/config.yaml 配置（PHP 版本、数据库类型与版本、Node.js、docroot、附加服务如 Solr）；Xdebug 调试、自定义命令（.ddev/commands/web/）、性能优化（macOS 下 Mutagen 或 NFS）。还涉及中断的 composer install 导致补丁未应用、超时被杀的 drush 留下孤儿进程、Docker 引擎卡死、Mutagen 同步挂起、路由 TLS 重置、APCu 陈旧缓存导致的 404 等问题的诊断与恢复。
使用方式：按需查阅 references/ 下对应文件，如 workflows.md、performance.md、xdebug.md、database.md、config-yaml.md、custom-commands.md、solr.md、load-and-recovery.md。常用示例：性能模式 ddev config --performance-mode=mutagen && ddev restart；端口冲突时 ddev config --router-http-port=8080 --router-https-port=8443；清理孤儿进程可用 ddev exec "pkill -f 'vendor/bin/drush'"；路由异常可 docker restart ddev-router。
适用场景：使用 DDEV 的 Drupal 本地开发、远程数据库同步、多项目与多智能体协作、内核测试与日常维护。
限制：原文未提供具体版本兼容范围、性能提升数值、收费或许可信息；部分排错步骤涉及强制终止进程与容器，需评估后再执行。