composer init 不能直接 install，因为它只生成空 composer.json，不创建 vendor、不安装依赖、不配置 autoload，也无 composer.lock；必须先运行 composer update 生成 lock 文件并装包。
composer init 生成的文件为什么不能直接 install
因为 composer init 只写 composer.json，不创建 vendor/、不安装包、也不配置 autoload —— 它只是个空壳。很多人填完就跑 composer install，结果报 No composer.lock file present 或 Class not found，其实是还没走到“能装”的阶段。
常见错误现象：
-
composer install报错No composer.lock file present：这不是提示你“该生成”，而是明确拒绝执行；必须先用composer update生成 lock 文件 - 类加载失败，但
composer show -s里看不到你的命名空间：说明autoload段没写，或路径/命名空间不匹配 -
composer install提示no matching package found：大概率是require里写了不存在的包名（比如拼错monolog/monolog）或版本号（如写成php >=8.1，正确应为php:^8.1）
怎么跳过交互快速生成可用的 composer.json
想省掉问答流程，直接生成一个能立刻 composer install 的基础配置，用这个命令：
composer init --name=myorg/myapp --description="My CLI tool" --require="php:^8.1" --no-interaction
注意几个关键点：
-
--require只接受vendor/package:version格式，不能写php >=8.1，得用php:^8.1 -
--autoload-psr4在新版 Composer 中已被移除，别指望它自动加 autoload；生成后得手动补上，比如："autoload": {"psr-4": {"App\": "src/"}} - 生成后立刻运行
composer validate，检查name是否含 vendor 段（如myorg/myapp），否则会报The package name is invalid.
新项目第一次 install 该用 install 还是 update
新项目刚初始化完 composer.json，没 composer.lock，此时必须用 composer update，不是 install。
原因很直接：composer install 是部署动作，只读 lock 文件；composer update 才是解析 composer.json、算依赖树、生成 lock 并装包的动作。
容易踩的坑：
- 误删
composer.lock后只跑composer install：新版 Composer(v2.5+) 会报Command "install" is not defined；旧版可能静默失败，但vendor/一定不完整 - 团队协作中删 lock 文件再 install：会导致不同人装出不同版本，破坏可复现性；应优先用
composer update --lock微调 - CI/CD 环境里混用
update：线上部署永远用composer install --no-dev，开发阶段才用update
autoload 配置写错导致 Class not found 怎么排查
最常见的是命名空间和目录结构对不上。比如声明了 "App\": "src/"，那就意味着 AppFooBar 必须对应 src/Foo/Bar.php；如果类写成 namespace App; 却放在 src/Controllers/Hello.php，就会找 AppHello 而不是 AppControllersHello。
实操建议：
- 改完
autoload后，必须运行composer dump-autoload，否则缓存不更新 - 用
composer show -s查看 autoload 映射是否生效，确认你的前缀已列在输出里 - 本地脚本或 CLI 工具推荐 type 设为
project（默认），别选library——后者会触发 Packagist 兼容检查，徒增干扰 - 如果只是临时测试，可加
"private": true到composer.json，避免误推到 Packagist
真正麻烦的不是生成配置，而是配置之后的验证链：name 格式对不对、autoload 路径映射严不严格、lock 文件有没有被误删、PHP 版本和 require 里的约束能不能对上——漏掉任意一环，composer install 就会卡住，而且错误信息往往不直接指向根源。
