Composer init如何创建文件_Composer项目配置初始化教学-composer-PHP中文网

composer init 仅生成 composer.json 文件，不创建目录、不安装依赖、不配置 autoload、不生成 vendor/ 及 vendor/autoload.php。

composer init如何创建文件_composer项目配置初始化教学

composer init 只生成 composer.json，不创建目录、不安装包、不写 autoload、不建 vendor/。你执行完就去 require 'vendor/autoload.php'，报错是必然的——它根本没生成那个文件。

composer init 生成什么、不生成什么

它只是把你在交互中填的字段（或参数）原样转成 JSON 写进 composer.json，其他一概不管：

不会创建 src/、tests/、public/ 等任何目录
不会运行 composer install，所以 vendor/ 和 vendor/autoload.php 都不存在
不会自动探测已有类或命名空间，更不会帮你配 autoload
不会校验 PHP 版本兼容性，也不会检查 require 里的包是否存在

常见错误现象：Class not found 却发现 composer.json 根本没有 autoload 字段；或者 composer install 报 No matching package found，其实是 require 里写了 monolog/monolog:^3.0，但当前 PHP 是 7.4 —— init 不管这个。

交互式 init 容易踩的三个硬坑

交互流程看着简单，但每步填错都会导致后续失败：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

Package name 必须是 vendor/name 格式，比如 acme/cli-tool；填 myapp 或 MyApp 直接报 Invalid package name
Author 必须带邮箱且格式正确：John Doe <john></john>；中文邮箱、缺、空格错位都会让 composer validate 失败
问到 Would you like to define your autoload rules? 时选 yes，它只支持 classmap，**不支持 PSR-4**；想用命名空间自动加载，必须手动改 composer.json 加 "psr-4": {"App\": "src/"}

非交互初始化怎么写才不翻车

脚本、CI、批量建项目必须用 --no-interaction，但它不兜底，缺一个参数就退出：

--name 和 --author 是必需的，漏掉直接失败；推荐写法：composer init --no-interaction --name="myorg/myapp" --author="Me <me>"</me>
--autoload 必须传完整 JSON 字符串，且用单引号包裹，双反斜杠不能少：--autoload='{"psr-4":{"App\":"src/"}}'；写成 "App":"src/" 会被 shell 提前解析，JSON 无效
--require 要拆开写，每个依赖单独一个 --require 参数：--require="php:^8.1" --require="guzzlehttp/guzzle:^7.8"；合并或漏版本号（如 guzzlehttp/guzzle）会报 Could not parse version constraint

生成后立刻要做的三件事

别急着写代码，先确认基础是否立住：

立刻跑 composer validate：它能秒级发现 name 缺 vendor 段、license 是空值、JSON 有全角引号等硬伤
确认 type 字段：本地 CLI 工具或网站填 "type": "project"；只有明确要发布为别人 require 的库，才设 "type": "library"；填错会导致 autoload 不生效或 CI 拒绝构建
补完 autoload 后必须手动运行 composer dump-autoload：仅 install 或 update 不会重建自动加载映射；路径写错（如 "src/" 但实际目录叫 lib/）、命名空间末尾少一个反斜杠（"App" 而非 "App\"），都会让 class_exists() 返回 false