Composer install 报“Directory is not empty”错误是因为其默认拒绝在非空目录中创建项目，需确认是否真要覆盖；若确需初始化，应清理 vendor/、composer.json、composer.lock 等非配置文件，或改用子目录安装再迁移。
composer install 报错“Directory is not empty”怎么办
这不是 Composer 拒绝工作，而是它在保护你——当你在一个已有文件的目录里执行 composer create-project 或手动放了 composer.json 后直接跑 composer install，它会检查目标路径是否干净。常见于从 Git 克隆后误删了 vendor/ 却没清空其他残留（比如 .env、public/index.php），或用 composer create-project xxx . 覆盖当前目录时目录非空。
- 先确认是不是真要覆盖：如果当前目录是已有项目，别硬上
create-project，改用composer install（前提是composer.lock存在） - 如果确实是想初始化新项目且目录已存在内容，必须明确告诉 Composer 你接受覆盖：
composer create-project vendor/package . --remove-vcs --no-interaction -
--remove-vcs会删掉.git目录，避免新项目混进旧仓库历史；--no-interaction防止卡在交互式提示 - 若报错来自
composer install（不是 create-project），说明你可能漏掉了composer.lock，导致 Composer fallback 到 update 行为，并试图写入已存在的文件结构——此时应先确认ls -l composer.json composer.lock是否齐全
为什么 composer create-project . 在非空目录里失败
默认行为就是拒绝覆盖。Composer 不会自动清理你目录里的 README.md、.env.example 或 public/ 这类文件，哪怕它们和模板不冲突。它只认“空目录”这个硬条件，不区分文件类型。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 错误信息通常是：
Dirname "xxx" is not empty, can't create project（注意不是 Permission denied 或 Class not found） - 不要手动
rm -rf *再试——这会删掉你自己的配置文件（如.env），正确做法是只删 Composer 管理范围外的临时文件：rm -f composer.json composer.lock vendor/，保留你手写的配置 - 如果你需要保留部分文件（比如自定义的
docker-compose.yml），就别用.当目标目录，换一个干净子目录：composer create-project laravel/laravel myapp，再把必要配置复制过去 - 某些模板包（如 Symfony 的
skeleton）会在post-create-project-cmd里做清理，但前提是目录能先被创建出来——所以非空问题必须前置解决
CI/CD 中遇到 “Directory is not empty” 怎么绕过
GitLab CI 或 GitHub Actions 默认工作目录不是空的（含 .git、.github/ 等），直接 composer create-project . 必败。这不是 bug，是预期行为。
- 标准解法：不往
.装，而是装到子目录再移动，例如：composer create-project laravel/laravel tmp-app --no-install && mv tmp-app/.git . && mv tmp-app/* . && mv tmp-app/.* . 2>/dev/null || true && rm -rf tmp-app
- 更稳妥的是放弃
create-project，改用git clone模板仓库 +composer install—— 这样你能完全控制初始文件集，也避开所有目录校验 - 如果必须用
create-project，加--prefer-dist和--no-scripts减少副作用，但无法跳过空目录检查 - 注意：Docker 构建中
WORKDIR若指向已挂载卷，也会触发此报错——此时应在 Dockerfile 里先RUN rm -rf /app/*（确保安全前提下）
容易被忽略的软性非空：隐藏文件和符号链接
你以为目录空，其实 ls 看不见的 .git、.env、.editorconfig 或一个坏的 symlink 就足以让 Composer 拒绝写入。它检查的是 inode 数量，不是肉眼可见内容。
- 运行
ls -la确认有没有隐藏文件；用find . -maxdepth 1 -type l查是否有 dangling symlink -
composer create-project对 symlink 敏感：如果当前目录是某个路径的软链（比如myapp -> /home/user/projects/real-app），它会报错，即使目标路径为空 - Mac 上的
.DS_Store、Windows 的Thumbs.db也会被计入——虽然不影响功能，但会触发非空判定 - 最省事的验证方式：
mkdir /tmp/test && cd /tmp/test && composer create-project symfony/skeleton .成功了，说明问题出在原目录的“隐形内容”上
