直接执行composer init可交互生成基础composer.json，但手动创建时最小必要结构须含"name"（vendor/name格式）和"type"（如project）或"require"字段，缺autoload则自身类无法自动加载。
直接执行 composer init 就能交互式生成基础 composer.json，不需要手写——但如果你跳过交互、想手动创建，关键不是格式对不对，而是字段是否满足后续 composer install 或依赖管理的实际需要。
手动创建 composer.json 的最小必要字段
空的 composer.json 会导致 composer install 报错：Your requirements could not be resolved to an installable set of packages.。真正必需的只有 {}，但没用；实际能跑起来的最小结构至少包含 "name" 和 "type"（或 "require"）：
{
"name": "myvendor/myproject",
"type": "project",
"require": {}
}
注意："name" 必须含斜杠（vendor/name 格式），否则 Composer 会警告并可能拒绝加载自动加载规则；"type": "project" 明确告诉 Composer 这是根项目而非库，影响 autoloader 行为。
autoload 字段不填会怎样？
不写 "autoload" 不影响 composer install 执行，但一旦你用 require 'vendor/autoload.php'，就只能加载已安装的第三方包——你自己写的类不会被自动引入。常见错误现象：PHP Fatal error: Class 'AppHttpController' not found。
- 类文件在
src/下 → 填"psr-4": { "App\": "src/" } - 单个文件如
functions.php→ 用"files": ["src/functions.php"] - 漏掉末尾反斜杠或命名空间大小写不一致，
composer dump-autoload不报错但运行时找不到类
composer install 失败的三个高频原因
即使 composer.json 语法正确，初始化仍常卡住。重点排查：
-
"require"中写了不存在的包名或版本（例如"monolog/monolog": "3.0.0"，但最新稳定版是2.x） - PHP 版本不匹配：在
composer.json里加"config": { "platform": { "php": "8.1.0" } }可强制模拟环境，避免本地 PHP 版本过低导致解析失败 - 没删掉
vendor/和composer.lock就反复install——首次初始化建议先rm -rf vendor composer.lock再运行
手动写 composer.json 最容易忽略的是 "autoload" 配置和 "name" 的命名规范，这两处出问题不会立刻报错，但会在几小时后让你在自动加载或 Packagist 提交时卡住。
