Composer init命令流程_Composer项目初始化交互说明-composer-PHP中文网

composer init 仅是 json 填空向导，填错包名格式、autoload 路径或 php 版本约束将导致 class not found 或 ci 失败；包名必须为全小写 vendor/name 格式，含字母数字和连字符，不可含空格或中文；autoload 默认不配 psr-4，需手动添加并运行 dump-autoload；--no-interaction 模式下必须显式传入 --name、--author、--type 等参数；type 应根据项目性质设为 project 或 library；填完必须立即执行 composer validate 和 composer install。

composer init命令流程_composer项目初始化交互说明

直接运行 composer init 不会初始化项目，它只是个 JSON 填空向导；填错任意一项（比如包名格式、autoload 路径、PHP 版本约束），后续 class not found 或 CI 失败就是确定结果。

Package name 必须是 vendor/name 格式

输入 myapp、MyApp、my_app 都会卡住或报 Invalid package name。Composer 强制校验：vendor 和 name 两段都必须全小写、只含字母数字和连字符、不能以数字开头、不能有空格或中文。

当前目录叫 My Blog App？先重命名：mv "My Blog App" my-blog-app
Git 用户名含中文或空格？别依赖自动读取，显式传参：composer init --name="acme/myapp"
老项目迁移时，目录名是 legacy-site，但包名应填 acme/legacy-site，不是 legacy-site
填错会导致 composer validate 报错、Packagist 拒绝提交、PHPStan 跳过分析

autoload 不会默认配 PSR-4，手动加才生效

交互中问到 Would you like to define your autoload rules?，选 yes 后只能配 classmap，不支持 PSR-4 —— 这是长期存在的限制。你 src/ 下的 App\Example 类，不手动加配置就永远加载不了。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

必须编辑 composer.json，加这段（注意双反斜杠）："autoload": { "psr-4": { "App\": \"src/\" } }
命名空间末尾的反斜杠必须双写，写成 "App": "src/" 是 JSON 语法错误
路径 "src/" 必须真实存在，且相对于 composer.json 所在目录；写成 "./src/" 或 "lib/"（而类实际在 src/）都会让 composer dump-autoload 生成空映射
改完立刻运行 composer dump-autoload，否则新规则不生效

--no-interaction 不是跳过，是“缺一不可”

加了 --no-interaction 后，命令不会提供任何默认值。缺 --name、--author 或 --type 中任意一个，它直接退出，连文件都不生成。

最小可用命令：composer init --no-interaction --name="myorg/myapp" --author="Me <me>" --type=project</me>
加依赖要拆开写：--require="php:^8.1" --require="guzzlehttp/guzzle:^7.8"，不能合并成一个字符串
配 autoload 的非交互写法：--autoload='{"psr-4":{"App\":"src/"}}'，单引号包裹，双引号必须转义
如果类在 lib/，路径必须同步改成 "lib/"，错一个字符 autoload 就失效

type 字段影响 autoload 是否被外部引用

type 默认是 library，但绝大多数人初始化的是 CLI 工具、网站或脚本——这类项目该设为 project。填错会导致两个后果：一是别人 require 你的包时意外触发 autoload（不该被当库引用），二是某些工具（如 Symfony Flex）完全忽略你的配置。

本地应用/工具：显式写 "type": "project"
打算发布成可被其他项目 require 的通用库：才用 "type": "library"
type 不影响 composer install 行为，但会影响 composer dump-autoload 是否生效，以及 Packagist 的兼容性检查
即使没依赖，也必须执行一次 composer install，否则 vendor/autoload.php 不会出现

最容易被忽略的点：填完后不立刻跑 composer validate。它能提前发现 name 缺 vendor 段、license 写成 MIT License（应为 MIT）、authors 缺邮箱、JSON 字段拼写错误（如 autoloa）等硬伤——这些错误等到 CI 报错才查，已经晚了。