composer init 默认生成的配置常出错：name 必须为 vendor/name 格式（如 acme/blog），autoload 字段缺失导致类无法加载，PHP 版本约束应写入 require 而非 config.platform。
直接运行 composer init 就能生成，但默认值几乎总是错的——尤其 name 格式不合法、autoload 完全缺失、PHP 版本没写进 require。别信“一路回车就行”，那大概率导致后续 composer install 成功但类加载失败。
为什么 composer init 生成的 name 常报错？
它要求格式必须是 vendor/name（带斜杠），比如 myorg/myapp；填 myapp 或 MyApp 都会提示 Invalid package name。Composer 不会自动补斜杠，也不会校验 vendor 段是否合法（比如含大写字母或下划线）。
- 合法示例：
"name": "acme/blog"、"name": "local/test-project" - 非法示例：
"name": "blog"（缺 vendor）、"name": "Acme/Blog"（大写）、"name": "acme_blog"（下划线） - 本地项目不想发布？填
local/xxx最省事，composer validate能过就行
autoload 字段为空是最大隐患
交互式流程从不主动问你自动加载规则，autoload 字段压根不会出现。结果就是：哪怕你写了 AppHello 类放在 src/ 下，require_once 'vendor/autoload.php' 也完全加载不了——因为 JSON 里根本没映射。
- 最简修复：手动加这段到
composer.json（改掉命名空间和路径）：{ "autoload": { "psr-4": { "App\": "src/" } } } - 注意反斜杠要双写（JSON 字符串转义），目录路径必须真实存在
- 加完立刻运行
composer dump-autoload，否则新规则不生效
PHP 版本约束为什么总被忽略？
交互最后会问 “PHP version”，但填了 ^8.1 后，它只会塞进 config.platform.php，而这个配置只影响本地依赖解析，对别人 require 你时毫无约束力。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 正确写法：在
require里显式声明："require": { "php": "^8.1" } - 验证是否生效：运行
composer check-platform-reqs，它检查的是require里的约束，不是config.platform - 漏写会导致别人在 PHP 7.4 上
composer require your/package成功，但运行时报语法错误
CI/脚手架场景下怎么跳过交互？
--no-interaction 本身不安全——它用默认 root/root 当包名，且其他字段全空。真要自动化，必须配合参数预设：
- 最小可用命令：
composer init --name=myorg/myproject --type=project --no-interaction - 想预设 PHP 版本？不行，
init不提供该参数，只能生成后手动改require字段 - 更可靠的做法：直接
echo '{...}' > composer.json写死最小配置，比依赖init的默认逻辑更可控
真正容易被忽略的点是：生成 composer.json 后，composer install 只负责拉依赖和写 vendor/，它不会帮你创建 src/ 目录、不会初始化 Git、也不会校验 autoload 路径是否存在——这些都得你手动确认，否则第二天就发现自动加载失效，却查不出哪行 JSON 写错了。
