解决因在非空目录中初始化导致Composer install报错-composer-PHP中文网

composer install 报“directory is not empty”错误是因为其默认拒绝在非空目录中创建项目，需确认是否真要覆盖；若确需初始化，应清理 vendor/、composer.json、composer.lock 等非配置文件，或改用子目录安装再迁移。

解决因在非空目录中初始化导致composer install报错

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 . 成功了，说明问题出在原目录的“隐形内容”上