composer init 卡在“Package name”因目录名含空格/大写/特殊字符，需重命名目录或用 --name 参数跳过；require 填约束表达式（如 ^2.0 或 dev-main），非版本号；autoload 需手动添加 PSR-4 配置；Windows 下路径含空格须换路径或改用 Git Bash。
composer init 会卡在“Package name”这一步
默认情况下 composer init 会尝试自动推导包名，比如从当前目录名生成 vendor/name 格式，但一旦目录名含空格、大写字母或特殊符号（如 my-project-v2!），它就直接卡住或报错 Invalid package name。这不是 bug，是校验逻辑严格——Composer 要求包名必须全小写、仅含字母数字、连字符和下划线，且以字母开头。
实操建议：
- 初始化前先重命名目录，例如用
mv "My Project" my-project； - 运行
composer init --name="your-vendor/your-package"跳过交互式包名输入； - 如果已卡住，按
Ctrl+C中断，别硬等，再带参数重试。
require 依赖时 dev-main 和 ^2.0 写法差异很大
交互过程中问到 “Which version constraint to require for…”，这里填的不是版本号，而是 约束表达式。填 dev-main 表示锁定当前 main 分支的最新提交（适合本地开发调试），填 ^2.0 表示允许安装 2.x 的任意兼容版本（遵循 SemVer）。填错会导致后续 composer install 失败或拉取意外版本。
常见错误现象：
- 填了
main或master—— Composer 不识别，报Could not find package； - 填了
2.0.0（无符号）—— 安装后锁定死版本，升级困难； - 填了
*—— 允许任意版本，极可能引发冲突或破坏性更新。
推荐做法：日常开发用 ^2.0，对接未发版的上游仓库用 dev-main，并确认该仓库已启用 "minimum-stability": "dev"。
生成的 composer.json 缺少 autoload 配置
composer init 默认不问 autoload，所以新建项目如果要跑 PHPUnit 或加载自己写的类，composer dump-autoload 会找不到文件。这不是漏步骤，是设计如此——它只管依赖，不管代码组织。
使用场景：你写了个 src/Hello.php，想用 new Hello() 直接实例化。
实操建议：
- 手动在生成的
composer.json里加一段："autoload": { "psr-4": { "App\": "src/" } }； - 改完立刻执行
composer dump-autoload，否则不会生效； - 别信交互提示里的 “Do you want to define your autoload settings?” —— 它只支持 classmap，不支持 PSR-4，选 yes 反而更麻烦。
Windows 下路径空格导致 composer init 报错
在类似 C:UsersJohn Doeproject 这种含空格的路径下运行 composer init，命令行可能把路径截断成 C:UsersJohn，然后报 Directory not found 或直接退出。这是 Windows cmd/powershell 对空格路径处理不一致导致的，不是 Composer 本身问题。
解决方法很直接：
- 换到不含空格的路径，比如
C:devmyproject； - 或者用 Git Bash 运行，它对空格路径兼容更好；
- 绝对不要用双引号包裹路径来“修复”，
composer init不吃这一套。
autoload 和路径空格这两处，最容易被跳过，等跑测试或部署时才暴露——那时再回头改，反而要清理 vendor 重装，比初始化时多花三倍时间。
