composer init易卡在作者格式上，因硬性要求Name <email@example.com>格式，缺尖括号、空格或邮箱域名均报错；手动创建时最常漏autoload配置和PHP版本约束。
直接在项目根目录跑 composer init 就能生成 composer.json，但跳过这步手动写也完全可行——关键是后续依赖安装和自动加载能不能通，而不是“必须交互式初始化”。
为什么 composer init 容易卡在作者格式上？
它硬性要求作者字段是 John Smith <john@example.com> 这种带邮箱的完整格式，空格、尖括号、邮箱域名缺一不可。Windows 终端或某些 Shell 下粘贴容易带不可见字符，直接手输更稳。
- 如果只是本地测试项目，
composer init时所有提示都直接回车，最后输入n跳过依赖定义，也能生成可用的最小composer.json - 若想跳过交互，用
composer init --name=myorg/myproject --description="test"一次性指定关键字段 - 作者字段填错会报
Invalid author string. Must be in the format: John Smith <john@example.com>，不是网络问题，别折腾代理
composer.json 手动创建时最常漏的两件事
新手常以为只要写好 require 就够了，结果类文件死活不自动加载——问题往往出在 autoload 配置或 PHP 版本约束没设。
-
"autoload": { "psr-4": { "App\": "src/" } }—— 注意末尾反斜杠和路径斜杠方向，Windows 下也用/，不是 - 必须加 PHP 版本约束，否则装高版本包可能失败：
"require": { "php": ">=8.1", "guzzlehttp/guzzle": "^7.8" } - 如果项目没有命名空间（比如全是函数式脚本），就别配
autoload，否则 Composer 会尝试加载却找不到类，报Class not found
composer install 和 composer update 到底该用哪个？
刚初始化完、第一次拉依赖，或者团队协作时新成员克隆项目后，必须用 composer install；只有你明确要升级某个包或更新整个依赖树时，才用 composer update。
立即学习“PHP免费学习笔记（深入）”；
-
install严格按composer.lock安装，保证所有人环境一致；没lock文件时它会先生成一份再安装 -
update无视lock，重新解析composer.json并拉最新兼容版本，可能导致意外行为（比如某包小版本更新改了 API） - CI/CD 流水线里应禁用
update，只允许install，避免构建结果漂移
入口文件引入 vendor/autoload.php 前必须确认的路径
常见错误是写成 require 'vendor/autoload.php';，但实际执行文件不在项目根目录（比如放在 public/ 下），导致相对路径失效。
- 用
__DIR__向上找：require __DIR__.'/../vendor/autoload.php'; - 或者先
chdir()到项目根目录再引入，但不如前者干净 - 如果用 Apache，确保
public/是 DocumentRoot，而vendor/不在 Web 可访问路径下（否则有泄露风险）
真正容易被忽略的是：Composer 初始化本身不决定项目结构，它只管依赖和加载。你把类放哪、怎么命名空间、是否分层，全靠自己定；composer.json 里写的 autoload 规则，必须和真实目录结构严丝合缝，差一个字母或斜杠，自动加载就静默失败。
