composer.json 的 required 字段版本号必须用双引号包裹，否则因违反 json 标准导致解析失败；autoload 配置错误不报明确提示，需手动 dump-autoload 且路径须相对于 composer.json 目录；scripts 命令依赖系统 path，require-dev 中的 autoload 规则仍生效，上线前须用 --no-dev 验证。
composer.json 的 required 字段必须用双引号包住版本号
不加引号或用单引号，Composer 会把它当 PHP 表达式解析，直接报错 Parse error: syntax error, unexpected '1.2.3'。JSON 标准要求字符串必须用双引号，Composer 不做容错。
-
"php": "^8.1"✅ 正确 -
"php": ^8.1❌ 解析失败，不是合法 JSON -
"php": '^8.1'❌ 单引号在 JSON 中非法 - 版本号里含
-dev、@dev等后缀时，同样必须加双引号，比如"monolog/monolog": "3.0.x-dev"
autoload 配置写错会导致 class not found 却不报 autoload 错误
Composer 只在执行 dump-autoload 或安装时校验 autoload 结构，运行时出错只抛 Class not found，根本不会提示“你 autoload 路径配错了”。常见错法是路径写成相对 vendor 的位置，实际它始终相对于 composer.json 所在目录。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 想自动加载
src/Helper.php，应写"psr-4": {"App\": "src/"}，不是"src/Helper.php"或"./src/" -
classmap要指向目录或具体文件，但路径必须存在且可读，否则dump-autoload会静默跳过（不报错，也不生成映射） - 改完
autoload后必须手动运行composer dump-autoload，否则新配置不生效
scripts 里调用的命令必须在当前环境 PATH 中可用
Composer 的 scripts 是 shell 命令，不是 Composer 内置指令。写 "post-install-cmd": "npm install"，如果系统没装 Node.js 或 npm 不在 PATH，就会卡住并报 sh: npm: not found，但 Composer 默认只显示“Script npm install handling the post-install-cmd event returned with error code 127”——错误信息藏得很深。
- 优先用
vendor/bin/xxx调用项目级工具，比如"phpunit"改成"./vendor/bin/phpunit" - 跨平台脚本慎用
&&或;，Windows 下 cmd 不认&&，建议拆成多个 script 条目或用composer-run-script类插件 - 调试 scripts 时加
-v参数，比如composer run test -v，能看到真实执行的 shell 命令和完整错误输出
require-dev 依赖在生产环境被自动排除，但 autoloading 不受此影响
很多人以为把包放进 require-dev 就彻底“隔离”了，结果上线后发现 Class not found。问题在于：Composer 安装时确实不拉 require-dev 的包，但它生成的 autoload 映射文件（vendor/autoload.php）仍包含所有已配置的 autoload 规则——哪怕对应包根本不存在。
- 如果
autoload里写了"psr-4": {"Tests\": "tests/"}，而tests/目录下有类，这些类的映射仍会进 autoload 文件；但若tests/依赖phpunit/phpunit，而该包只在require-dev里，运行时就会因找不到父类报错 - 解决方案不是删 autoload，而是确保
autoload描述的路径和类真实存在，且不强依赖require-dev中的运行时类 - 上线前跑
composer install --no-dev，再检查vendor/autoload.php是否还能正常 require 到关键类
composer.json 最容易翻车的地方，不在语法多复杂，而在“它看起来跑通了，其实只是因为本地恰好有 dev 依赖、或者 autoload 没触发、或者错误被静默吞掉了”。每次改完，最好清掉 vendor 和 composer.lock，用最小环境重装一次。
