composer init 交互式生成符合规范的 composer.json，跳过输入会使用默认值（如 type=library）；若目录已存在 composer.json 则报错，需删除或换目录；关键字段 name 需 vendor/name 格式，type 建议显式设为 project，require 版本约束需加引号。
composer init 命令会交互式生成 composer.json
它不是一键创建空文件，而是通过终端提问引导你填入包名、描述、依赖等信息，最终生成一个结构完整、符合规范的 composer.json。如果你跳过交互直接回车，大部分字段会留空或使用默认值（比如 name 会变成 username/package-name），但 type 默认是 library，这点容易忽略。
运行前必须确保当前目录为空或不含已有 composer.json
composer init 会检查当前目录是否存在 composer.json，如果已存在，会直接报错：Cannot initialize a project inside an existing composer.json directory。解决方法只有两个：
– 删除旧文件（rm composer.json）
– 换个干净目录重新执行
别试图用 --force 覆盖——这个参数根本不存在，是常见误解。
关键字段填写建议和陷阱
交互中几个字段需要特别注意：
-
name：格式必须是vendor/name（如myorg/myapp），不能只写myapp，否则后续composer install可能报Invalid package name -
type：如果是可运行项目（如 CLI 工具或 Web 应用），建议显式设为project；默认library会影响某些自动化工具的行为 -
require：输入php: ^8.1这类版本约束时，记得加引号，否则 shell 可能误解析^ - 最后一步问是否“do you want to store credentials”——选
n即可，除非你真要往~/.composer/auth.json写私库账号
想跳过交互？用 --no-interaction + 其他参数组合
适合 CI 或脚本批量初始化，例如：
composer init --no-interaction \ --name "myorg/myapp" \ --description "My CLI tool" \ --type project \ --require "php:^8.1" \ --require-dev "phpunit/phpunit:^10"
注意：--require 和 --require-dev 可多次出现，但每个只能带一个依赖；多个依赖得拆成多条 --require。另外，--no-interaction 不会自动生成 autoload 配置，如有需要得手动加或后续用 composer config 补。
真正麻烦的不是命令本身，而是生成后没检查 autoload 字段是否符合实际目录结构——很多新手跑 composer dump-autoload 失败，回头才发现 "psr-4": {"App\\": "src/"} 里写的 src/ 根本不存在。
