composer init 卡住或报错主因是包名校验失败、PHP扩展缺失或交互中断；需确保包名全小写且合法、补全autoload配置、启用CLI所需扩展（如mbstring/xml/zip），并手动运行dump-autoload。
新项目执行 composer init 卡住或报错，基本不是 Composer 坏了，而是包名校验失败、PHP 扩展缺失或交互流程被误中断——它不会“自动跳过”，必须显式满足规则才能继续。
composer init 卡在 Package name 输入环节
这不是卡死，是严格校验：包名必须全小写、只含字母数字/连字符/下划线、不能以数字开头、不能有空格或中文。目录叫 My App 或 api_v2!，命令就停在这一步不动。
- 立刻按
Ctrl+C中断，别干等 - 重命名目录：比如
mv "My App" my-app - 或跳过交互，直接指定：
composer init --name="myorg/myapp" --no-interaction - 如果已生成不合法的
composer.json，删掉重来，别试图手动修
生成的 composer.json 缺 autoload 配置
composer init 默认不问 PSR-4，也不会自动加 autoload 字段。你填了 "App": "src/"，但后续 Class not found，大概率是字段根本没写进文件，或者路径写错。
- 手动编辑
composer.json，加入这段（注意命名空间末尾是双反斜杠）："autoload": { "psr-4": { "App\": "src/" } } -
"App\": "src/"中的路径必须相对于项目根目录；填./src/或绝对路径会失效 - 改完立刻运行
composer dump-autoload，否则不生效 - 如果类实际在
lib/下，"App\": "src/"必须同步改成"App\": "lib/"
执行 init 前 PHP 环境就不达标
报错信息里带 ext-xml、ext-mbstring、ext-zip 或 ext-simplexml 缺失，说明 CLI 模式下 PHP 扩展没启用——网页端 phpinfo() 显示正常，不代表命令行能用。
- 先确认 CLI 使用的配置文件：
php --ini，看Loaded Configuration File路径 - 编辑该
php.ini，取消注释：extension=mbstring、extension=xml、extension=zip、extension=simplexml - Linux/macOS 用户若用包管理器装 PHP（如 apt/brew），需单独安装扩展包，例如 PHP 8.2：
sudo apt install php8.2-mbstring php8.2-xml php8.2-zip - 别用
--ignore-platform-reqs掩盖问题——init 成功了，但后续composer install或autoload仍会崩
最常被忽略的是：init 只生成 composer.json，它不检查依赖是否可解析、不验证扩展是否真加载、也不生成 vendor/autoload.php。哪怕 init 成功，下一步跑 composer install 还可能因 composer.lock 缺失或平台约束失败而中断——得按阶段逐个确认。
