composer init仅生成空composer.json，不建vendor、不配autoload、不校验name格式；必须用--no-interaction配合--name、--author、--require等参数一次性填全，且name须为小写vendor/name格式，否则报invalid package name。
composer init 本身不快速，也不生成标准包结构——它只生成空 composer.json，其余全靠你手动补全。真要“快速初始化标准 PHP 包”，得绕过交互、跳过默认问答流，并立刻补上 autoload、PHP 版本约束和目录骨架。
为什么 composer init 会卡在 Package name？
它不是卡，是校验失败后静默挂起或报 Invalid package name。根本原因是：包名必须严格为 vendor/name 格式，且满足以下全部条件：
- 全小写（
MyApp❌，myapp❌，acme/myapp✅） - 仅含字母、数字、连字符、下划线（
acme/my_app✅，acme/my app❌） - 以字母开头（
acme/123blog❌） - 有且仅有一个
/（acme/blog/core❌）
常见触发场景：当前目录叫 My Project 或 php-v2!，composer init 尝试自动推导包名时直接失败。按 Ctrl+C 中断，别等。
用参数一次性生成最小可用 composer.json
加 --no-interaction 是必须的，但它不兜底——缺任何必需字段就退出，不写文件。以下是最小可用命令：
composer init --no-interaction --name="acme/my-package" --description="A reusable PHP package" --author="Me <me>" --type="library" --license="MIT" --require="php:^8.2"</me>
注意：
-
--require="php:^8.2"必须显式指定，否则composer validate会警告缺失 PHP 约束 -
--type="library"告诉工具这是可复用包，不是应用（project），影响 Packagist 解析和某些 CI 行为 - 不要漏
--author，格式必须带尖括号邮箱，Me或Me@example.com都会失败
autoload 不配，require 'vendor/autoload.php' 就白引
交互式流程里选 “yes” 定义 autoload 后，默认只给 classmap，不支持 PSR-4——这是长期坑点。非交互模式下必须手动传 JSON：
composer init --no-interaction
--name="acme/my-package"
--autoload='{"psr-4":{"Acme\MyPackage\":"src/"}}'
--author="Me <me>"
--license="MIT"
--require="php:^8.2"</me>
关键细节：
- 命名空间末尾反斜杠必须双写：
"Acme\MyPackage\"，单写"AcmeMyPackage"是非法 JSON - 路径
"src/"必须真实存在，且类文件需在src/下按命名空间层级存放（如src/Helper/Util.php对应AcmeMyPackageHelperUtil） - 运行完立刻建目录：
mkdir -p src，否则后续composer dump-autoload会跳过注册
初始化完必须立刻做的三件事
生成 composer.json 只是起点，以下操作漏一步，后续必出问题：
- 运行
composer validate：检查name格式、license是否为 SPDX ID（MIT✅，MIT License❌）、authors是否含邮箱 - 运行
composer install --no-dev：哪怕没 require 任何第三方包，也要走这一遍——否则vendor/autoload.php不生成，class_exists()永远 false - 手动创建
src/和基础类文件（如src/MyPackage.php），再跑一次composer dump-autoload验证映射是否生效
最易被忽略的是：没有 vendor/autoload.php，就不存在自动加载；没有 composer.lock，CI 就无法复现依赖版本。这两者都得靠 install 触发生成，init 本身不干这事。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
