composer init –name 必须指定 vendor/package-name 格式，vendor 为 Packagist 注册用户名，package-name 用小写短横线；name 字段决定 Packagist 路径、PSR-4 默认命名空间及依赖标识，错误会导致发布失败、自动加载异常与依赖解析错误。
composer init –name 生成的包名会被写进 composer.json 的 name 字段
这个字段不是可有可无的元数据，它直接决定 Packagist 上的注册路径、自动加载根命名空间（当使用 PSR-4）、以及依赖解析时的唯一标识。如果留空或填错，后续发布到 Packagist 会失败，composer require 也无法按预期引用。
实操建议：
-
composer init --name后必须跟vendor/package-name格式，中间用斜杠分隔，不能是单个单词（如myapp）或下划线（如my_app） - vendor 名通常是你在 Packagist 的用户名或组织名，需与实际注册账号一致；package-name 应小写、用短横线（kebab-case），比如
monolog/monolog、symfony/http-Foundation - 如果本地开发暂不发布，也建议按规范填，避免后期改名引发 autoload 重映射、git 历史污染等问题
不加 –name 时 name 字段默认为空，但 vendor 和 package 会被推断为当前目录名
执行 composer init 不带 --name，它会提示 “Package name (laravel-api-client，它可能建议 root/laravel-api-client，其中 root 是错误的 vendor。
常见错误现象：
- 推断出的 vendor 是
root或username（系统用户名），而非你在 Packagist 注册的 vendor 名 - 目录名含大写字母或下划线，导致生成的 name 不符合 PSR-4 自动加载要求（Composer 默认将
vendor/name映射为VendorName命名空间） - 后续运行
composer install时，若项目被其他包依赖，name 不合法会导致依赖解析失败，报错类似Could not find package xxx at version *
name 字段影响 PSR-4 自动加载的默认根命名空间
如果你在 composer.json 中配置了 PSR-4，且没显式写 "autoload": {"psr-4": {"App": "src/"}}，那么 Composer 会尝试根据 name 字段生成默认命名空间：把 vendor/package-name 转为首字母大写的驼峰形式，如 acme/hello-world → AcmeHelloWorld。
这容易踩的坑：
- 实际代码里用了
App或MyApp命名空间，但name是acme/app，结果自动加载器找不到类 - package-name 含数字或特殊字符（如
my-app-v2），转换后变成MyAppV2，但你代码里写的是MyAppV2还是MyAppv2？大小写敏感环境下会出问题 - 多人协作时，有人改了
name却没同步更新autoload配置，CI 构建直接失败
初始化后修改 name 字段要同步检查 autoload 和测试入口
name 不是“设一次就完事”的字段。一旦项目已开始开发，改它不只是换一行 json，还会牵连：
- 所有
use语句中基于旧 name 推导的命名空间（比如从oldorg/tool改成neworg/tool，OldorgTool就全失效了） - phpunit.xml 中的
bootstrap或autoload路径是否还指向正确的 vendor/autoload.php？有些项目会硬编码 vendor 目录位置 - github Actions 或 gitlab CI 脚本里是否用到了
composer config github-oauth或composer publish类命令？它们可能依赖 name 字段构造仓库 URL
最稳妥的做法：初始化时就定好 vendor/package-name，别寄希望于“先随便填，以后再改”。真要改，用 ide 全局重命名 + 手动校验 autoload + 运行 composer dump-autoload -o 再跑一遍测试。