Composer怎么设置Composer忽略项_Composer项目规范化配置-composer-PHP中文网

composer没有忽略机制，所谓“忽略”实为依赖隔离（--no-dev）、autoload排除（exclude-from-classmap或不注册）及ci/cd校验规范（--dry-run）三类场景，需明确上下文执行对应命令。

composer怎么设置composer忽略项_composer项目规范化配置

Composer 本身没有 ignore 或 .gitignore 那样的“忽略项”机制——它不跳过某些包、不跳过某些文件夹、也不按规则跳过 autoload。所谓“忽略”，实际是三类不同场景的误称：依赖隔离、自动加载排除、以及 CI/CD 中的格式校验绕过。搞不清这点，容易在 composer.json 里瞎加字段，反而引发 Class not found 或 composer install 失败。

require-dev 里的包真能被“忽略”吗

能，但只在明确指定 --no-dev 时生效。这不是“忽略”，而是依赖作用域控制。

require-dev 中的包（如 phpunit/phpunit、phpstan/phpstan）不会出现在生产环境的 vendor/autoload.php 加载表中，前提是执行 composer install --no-dev
如果漏了 --no-dev，这些包仍会被安装、autoload 映射仍会生成，只是业务代码没调用而已——体积大、启动慢、还可能因 dev 包的副作用干扰运行时
CI/CD 流水线必须固化该参数：composer install --no-dev --optimize-autoloader，否则 autoload-dev 的映射仍会写入，失去隔离意义
别指望靠删掉 require-dev 字段来“临时忽略”——这等于删除契约，下次 composer update 可能拉错版本或缺失工具

autoload 里怎么排除某个目录不加载

Composer 不支持在 psr-4 或 classmap 中声明“排除路径”。所谓排除，只能靠两层手段实现：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

不把它写进 autoload 或 autoload-dev ——这是最干净的做法。比如 tests/ 只放 autoload-dev，bin/ 或 docs/ 根本不注册
用 exclude-from-classmap 配置项，仅对 classmap 生效：它会在生成 classmap 时跳过指定路径下的文件，但不影响 PSR-4 行为
示例配置：
```
"config": {
  "exclude-from-classmap": ["tests/", "docs/", "build/"]
}
```
注意：这个字段只影响 composer dump-autoload -o 生成的优化 classmap，对 PSR-4 加载完全无感
别试图用 files + glob 模拟排除——files 是白名单式包含，且每次请求都 include_once，性能和语义都不对

CI 里想跳过 composer format 校验某次提交

不能跳过，也不该跳过。所谓“忽略校验”，本质是流程设计缺陷。

composer format 是幂等操作，--dry-run 退出码为 1 表示有改动，0 表示已合规。CI 应该失败即拒收，而不是给例外
如果某次 PR 确实需要绕过（比如合并历史遗留分支），应在 CI 脚本里用条件判断，例如：
```
if ! composer format --dry-run; then
  echo "composer.json 格式不合规，请先运行 composer format";
  exit 1;
fi
```
而不是加 --force 或注释掉检查
真正要“忽略”的是那些非项目文件：比如 vendor/ 下的 composer.json、node_modules/ 里的 JSON、或自动生成的 composer.lock 差异——这些本就不该进 composer format 扫描范围
composer format 默认只处理当前目录下的 composer.json，不会递归。多项目仓库中，每个子项目应单独跑自己的 composer format，不要用 find . -name composer.json 全局扫