如何创建composer.json_Composer项目初始化规范-composer-PHP中文网

结论：不要手动写composer.json，用composer init交互式生成再微调，否则易漏autoload、minimum-stability或require-dev等关键字段，导致autoload失效或依赖安装失败。

如何创建composer.json_composer项目初始化规范

直接说结论：不要手动写 composer.json，用 composer init 交互式生成再手动微调，否则极易漏掉 autoload、minimum-stability 或 require-dev 等关键字段，导致后续 autoload 失效或依赖安装失败。

为什么 `composer init` 比手写更可靠

手写 composer.json 容易忽略 schema 隐含约束：比如 type 字段不填默认是 library，但如果你实际在写 CLI 工具，不显式设为 project，某些打包工具（如 humbug/box）会跳过自动发现；又比如 autoload 缺失时，composer dump-autoload 不报错，但 new YourClass() 会直接 Class not found。

使用 composer init 能强制你回答包名、描述、作者、PHP 版本要求、依赖项等核心问题，并自动生成合规结构：

composer init
# 会依次提示：
# Package name (<vendor>/<name>) [username/project]:
# Description []: 
# Author [<name><email>]: 
# Minimum Stability []: stable
# Package Type (library, project, metapackage, composer-plugin) []: library
# License []: MIT
# Define your dependencies.</email></name></name></vendor>

输入 ^8.1 作为 PHP 版本要求，它会自动写成 "php": "^8.1" 并放入 require
若项目要发布到 Packagist，vendor/name 必须与你在 Packagist 注册的用户名一致，否则 composer require 无法解析
如果只是本地开发项目（非可复用库），type 建议设为 project，避免被其他项目误 require

`autoload` 字段必须按需显式配置

90% 的 “Class not found” 问题都源于 autoload 配置缺失或路径错误。Composer 不会自动扫描 src/ 或 lib/ 目录 —— 除非你告诉它。

Workflow Decomposer

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

下载

常见场景及写法：

PSR-4 自动加载（推荐）："autoload": { "psr-4": { "App\": "src/" } }，注意末尾斜杠和命名空间结尾反斜杠必须存在
类文件集中放在 lib/ 且无命名空间？用 files："autoload": { "files": ["lib/helpers.php"] }
开发时想边写边加载，别忘了加 autoload-dev："autoload-dev": { "psr-4": { "App\Tests\": "tests/" } }
改完 autoload 后，必须运行 composer dump-autoload 才生效，install 或 update 不会自动触发

`require` 和 `require-dev` 的边界必须清晰

混淆这两者会导致生产环境意外引入开发工具（如 phpunit），或测试时找不到调试依赖（如 symfony/var-dumper）。

require 只放运行时必需的包，例如 "monolog/monolog": "^3.0"；框架类库（如 laravel/framework）也属于此列
require-dev 放测试、构建、分析工具："phpunit/phpunit": "^10.0"、"phpstan/phpstan": "^1.10"、"friendsofphp/php-cs-fixer": "^3.14"
执行 composer install --no-dev 时，require-dev 中的包完全不会安装，CI 流水线应默认加这个参数
如果某个包既用于开发又用于运行（如 symfony/dotenv 在本地读 .env，生产可能不需要），优先放进 require，再通过环境判断是否加载

最常被忽略的是 autoload 和 autoload-dev 的对应关系：写了 "App\Tests\": "tests/" 却没把 phpunit 放进 require-dev，或者写了 "psr-4" 却忘了运行 dump-autoload —— 这些都不是 Composer 的 bug，而是初始化阶段没把契约一次性对齐。