composer dump-autoload 会重新生成 vendor/autoload.php 及其依赖的加载映射文件（如 autoload_classmap.php、autoload_ps4.php 等），仅响应 composer.json 中 autoload 配置变更，不重装包或修改 composer.lock。
composer dump-autoload 会重新生成什么文件
执行 composer dump-autoload 的核心作用是重建 vendor/autoload.php 及其依赖的加载映射（如 vendor/composer/autoload_classmap.php、autoload_psr4.php 等），但不会重装包或修改 composer.lock。
它只响应 composer.json 中的自动加载配置变更（比如新增了 "psr-4" 映射、改了命名空间前缀、加了 "classmap" 路径），也适用于手动新增 PHP 类后快速让 autoloader 感知到——前提是这些类已落在已声明的自动加载路径下。
- 不加参数时，默认生成优化版（含 classmap）和标准 PSR 映射，适合开发环境
- 加
--optimize（或-o）会强制合并所有类到autoload_classmap.php，提升生产环境性能，但会忽略动态 require 或未扫描到的文件 - 加
--classmap-authoritative告诉 autoloader “类只可能在 classmap 里”，可跳过文件系统查找，但必须确保 classmap 完整，否则报Class not found
什么时候必须运行 dump-autoload 而不是 install/update
当你只改了 composer.json 的自动加载字段（"autoload" 或 "autoload-dev"），没动 "require" 或 "require-dev"，就不需要 composer install 或 composer update——它们不会触发 autoload 重建。
常见触发场景：
- 新增一个
src/Helper/StringUtils.php，并在composer.json中补上"App\Helper\": "src/Helper/" - 把测试用的
tests/目录从"autoload-dev"移到"autoload"，让生产也能用 - 删掉某个已废弃的
"classmap"路径，防止旧类被意外加载
如果跳过这步，new StringUtils() 会直接报错 Class 'AppHelperStringUtils' not found，哪怕文件存在、命名空间正确。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
autoload 未生效的三个典型原因
即使运行了 composer dump-autoload，仍可能加载失败。排查优先级如下：
-
composer.json中路径写错：比如写成"src/Helper"却漏了末尾斜杠，PSR-4 要求目录以/结尾；或者路径是相对composer.json所在位置的，不是相对于项目根目录 - 命名空间与物理路径不匹配：例如类声明为
namespace AppHelper;，但文件放在src/helpers/StringUtils.php（小写 helpers），PSR-4 区分大小写 - 缓存干扰：PHP OPcache 启用时，
vendor/autoload.php本身可能被缓存，导致新生成的映射不生效；可临时加opcache_reset()或重启 Web 服务
验证是否生效最直接的方式：在终端执行 php -r "require 'vendor/autoload.php'; var_dump(class_exists('App\Helper\StringUtils'));"，返回 bool(true) 才算真正就位。
使用 --no-dev 和 --optimize 的组合风险
在部署脚本中常看到 composer install --no-dev --optimize-autoloader，它会跳过 "autoload-dev" 配置并启用 classmap 优化。但要注意：
- 如果你的生产代码里引用了
"autoload-dev"下的类（比如某些命令行工具混在tests/里又被线上调用），就会报错 -
--optimize-autoloader不等价于dump-autoload --optimize：前者是 install/update 的子行为，后者是独立命令，两者触发时机和上下文不同 - CI/CD 中若先
install --no-dev再单独跑dump-autoload --optimize，后者会覆盖前者生成的 classmap，且可能包含 dev 文件（因为 dump-autoload 默认读取全部 autoload 配置）
真正安全的做法是明确区分环境：开发用 dump-autoload，生产用 install --no-dev --optimize-autoloader，不要混用命令链。
