composer init 不能一路回车，必须手动设置 name（格式 vendor/name）、autoload（推荐 psr-4，如 "App\": "src/"）和 PHP 版本（如 ^8.1），否则导致包不可发布、类无法自动加载或依赖安装失败。
直接用 composer init 就行，但别一路回车——它生成的默认值几乎总是错的，尤其 name 和 autoload。
为什么 composer init 生成的 composer.json 经常不能用
交互式初始化会按当前目录名猜 name（比如目录叫 test，它就填 test/test），但 Packagist 要求格式是 vendor/name，且 vendor 必须是你能控制的命名空间（比如 GitHub 用户名）。更关键的是，默认不配 autoload，意味着你写的类根本不会被自动加载。
-
name填错 → 后续composer install可能报Package not found或无法发布到 Packagist - 没设
autoload→require文件或new MyClass()直接Class not found - PHP 版本锁太松（如
^7.4）→ 在 PHP 8.2 环境下装包失败，却提示不明确
composer init 时必须手动干预的三个问题
启动后，前两步（package name、description）要停住改，别狂按回车：
-
Package name：输入your-github-username/your-project-name，比如john-doe/api-client；如果只是本地项目不想发包，也建议写成local/myapp，避免后续混淆 -
Autoloading选psr-4（不是psr-0，后者已废弃），然后填App\→src/（注意末尾斜杠和双反斜杠） -
PHP version：显式输入^8.1或^8.2，别留空或填*，否则 Composer 会默认用最低兼容版，导致依赖装不上
生成后立刻要检查的两处配置
文件生成完别急着跑 composer install，先打开 composer.json 看这两行：
jm-jsjkxyjs02-zlm-405
下载
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
-
"type": "project"→ 如果这是个可复用的库（比如你要发布为包），改成"library"；类型影响 Packagist 解析和安装行为 -
"autoload"下的"psr-4"映射是否指向真实存在的目录，比如"App\": "src/"，但你实际代码在lib/，那就得立刻改路径，否则自动加载失效
示例正确片段：
{
"autoload": {
"psr-4": {
"App\": "src/"
}
}
}
不用交互式初始化的替代方案
如果已经踩过坑、或者想批量初始化，直接手写最小可用 composer.json 更快：
- 新建空文件，粘贴以下内容（改掉
name和autoload路径即可） - 运行
composer install会自动补全vendor/autoload.php和锁文件
最小模板：
{
"name": "your-vendor/your-project",
"type": "project",
"autoload": {
"psr-4": {
"App\": "src/"
}
},
"require": {},
"config": {
"platform-check": false
}
}
真正麻烦的从来不是生成文件，而是 name 的语义一致性、autoload 路径与实际目录结构的严格匹配——这两个点一旦错，后面所有 autoload、classmap、IDE 支持都会连锁失效。
