composer init仅生成空壳composer.json，不创建vendor目录、不配置autoload、不运行install；卡在package name因目录名含空格/大写/特殊字符，须重命名或显式指定--name；后续必补composer install、psr-4 autoload配置及"type": "project"。
composer init 不是“创建项目”，它只生成一个空壳 composer.json；直接运行后去 require 'vendor/autoload.php' 必然报错——因为 vendor 目录根本没出现，autoload 也没配。
为什么 composer init 卡在 “Package name”
它会从当前目录名自动推导包名，但只接受全小写、数字、连字符、下划线 + 必须含 / 的格式（如 myorg/myapp）。目录名带空格、大写字母（MyProject）、中文或感叹号（demo-v2!）都会卡住或报 Invalid package name。
- 立刻重命名目录：
mv "My Project" my-project - 跳过交互，显式指定：
composer init --name="myorg/myapp" --no-interaction - 已卡住？按
Ctrl+C中断，别等，再带参数重试
composer init 后必须手动补的三件事
生成的 composer.json 是空骨架，不装包、不建目录、不配加载规则。以下三项漏一不可：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
运行
composer install：否则vendor/和vendor/autoload.php都不会存在 -
配
autoload：交互中选yes→psr-4→ 输入命名空间（如App）和路径（如src/）；否则即使装了包，new AppSomeClass()也会报Class not found -
设
"type": "project"：默认是library，但 CLI 工具、网站、脚本都该填project；填错会导致别人require你时意外触发 autoload，或某些工具（如 Symfony Flex）完全忽略配置
非交互模式下怎么安全初始化
--no-interaction 看似省事，但参数漏一个或格式错一点就失败：
-
php版本必须用约束符：--require="php:^8.1"，填8.1会被当成精确版本，composer install直接报错 -
--autoload值要用单引号包裹完整 JSON：--autoload='{"psr-4":{"App\":"src/"}}'（注意命名空间末尾双反斜杠是转义需要） -
--require可多次使用：--require="guzzlehttp/guzzle:^7.8" --require="monolog/monolog:^3.0"，不能合并成一个参数 - 生成后立刻跑
composer validate，检查字段缺失、邮箱格式、JSON 语法等隐形坑
别把 composer init 和 composer create-project 搞混
前者是填空式生成配置文件，后者是抄模板拉完整可运行项目。想开箱即用 Laravel 或 Symfony？用 composer create-project。想从零控制依赖、autoload、type 和目录结构？composer init 是唯一正解。
真正容易被忽略的点在于：composer.json 里 name 字段看似可选，但一旦漏掉或格式不对（比如缺 /、含大写），后续发布到 Packagist、被别人 require、甚至某些 CI 工具校验都会失败——它不是“能跑就行”的字段，而是包的唯一标识锚点。
