应使用 composer init 初始化空白项目，它只生成干净的 composer.json；卡在 Package name 是因目录名含空格/大写/特殊字符，需重命名或显式指定 --name；autoload 需手动添加 PSR-4 并运行 dump-autoload；require 中 php:^8.1 失败是因本地 PHP 版本低于约束；type 字段决定项目类型，默认 library 可能导致 require-dev 被忽略；即使无依赖也必须执行 composer install 以生成 autoload.php。
别用 composer create-project 初始化空白项目——它会拉框架骨架、执行钩子脚本、污染初始结构。真正该用的是 composer init，它只生成干净的 composer.json，不碰 vendor、不装包、不改目录。
composer init 为什么总卡在 Package name？
它会尝试从当前目录名自动推导包名，但校验极严：必须全小写、仅含字母数字/连字符/下划线、不能以数字开头、不能有空格或中文。目录名是 My Blog App 或 api_v2!，它就直接卡住或报错。
- 初始化前先重命名目录：
mv "My Blog App" my-blog-app - 跳过自动推导，显式指定：
composer init --name="myorg/myapp" --no-interaction - 已卡住？按
Ctrl+C中断，别等，再带参数重试
autoload 怎么配才生效？
composer init 默认不问 PSR-4，也不写 autoload 字段。你填了 "App": "src/" 却还是 Class not found，大概率是反斜杠没转义对，或者根本没加这段。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 交互中选 “Would you like to define your autoload rules?” → 选 no，它只支持 classmap，不支持 PSR-4
- 手动编辑
composer.json，加这段（注意双反斜杠）："autoload": { "psr-4": { "App\": "src/" } } - 改完立刻运行
composer dump-autoload，否则不生效 - 如果类在
lib/而非src/，路径必须同步改，错一个字符 autoload 就失效
require 里写 php:^8.1 为什么会 install 失败？
不是网络问题，是约束和环境对不上。php:^8.1 表示“PHP 8.1.x 或更高兼容版本”，但如果你本地是 PHP 7.4，composer install 就会直接退出，不给任何提示。
- 先确认真实环境：
composer show --platform看输出里的php行 - require 里别写
php >=8.1，必须用语义化版本符：php:^8.1或php:~8.1.0 - 加第三方包时别贪快，比如填
monolog/monolog:^1.0—— 它最高只支持 PHP 7.4，PHP 8.1 下必然失败 - 老项目升级 PHP 前，先改
composer.json里的require.php，再composer update
type 字段漏写或写错会怎样？
它不报错，但后果隐蔽：type 决定 Composer 把你当“应用”还是“库”来对待。默认是 library，但你写的是 CLI 工具或网站，却没改成 project，后续就容易出问题。
-
type: "project"→ 不会被其他项目require，require-dev正常安装，autoload 仅用于自身 -
type: "library"→ 会被别人引用，Composer 会检查 Packagist 兼容性，且 autoload 规则要严格匹配命名空间 - 不写
type？Composer 按library处理，可能导致composer install忽略require-dev，或某些工具（如 Symfony Flex）不触发配方 - 生成后立刻跑
composer validate，它能发现name缺 vendor 段、license格式不对等硬伤
最易被忽略的一点：即使 require 为空，也必须执行一次 composer install —— 否则 vendor/autoload.php 不生成，你在入口文件里 require 'vendor/autoload.php' 就会报错。
