安全重建composer.json需先兼容再替换最后收敛：备份现有文件，若无则init时选n跳过依赖交互，手动配置classmap映射旧目录（如"lib/"），避免默认PSR-4；入口统一引入vendor/autoload.php并确保路径正确；修改后必执行composer dump-autoload。
直接重装 composer.json 并不安全，旧项目往往已有手动引入的类、全局函数或非标准目录结构，盲目初始化会破坏现有加载逻辑。核心原则是：先兼容，再替换，最后收敛。
如何安全地重建 composer.json 而不中断运行
不要直接删掉旧的 composer.json（如果存在）或用 composer init 从头生成——它会清空你已有的 require 和 autoload 配置。正确做法是：
- 若已有
composer.json，先备份并检查内容，重点关注require字段是否还准确反映当前实际使用的依赖（比如旧版monolog/monolog锁在1.2.*，但代码里其实调用了 2.x 的接口，就会出错） - 若没有
composer.json，运行composer init时，在 “Do you want to define your dependencies (require) interactively?” 这一步选n，避免误加错误版本；之后手动编辑生成的文件，只填必要字段 - 务必保留原有
autoload配置逻辑（如classmap指向./lib或./includes），别默认改成 PSR-4 ——老项目几乎不用命名空间
autoload 怎么配才不会让旧类“突然找不到”
旧项目常见问题不是依赖装不上，而是 require_once 'lib/Database.php' 改成 new Database() 后报 Class 'Database' not found。这是因为 Composer 默认不加载非命名空间类，必须显式映射：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
classmap最稳妥："autoload": { "classmap": ["lib/", "models/", "helpers/"] }，然后运行composer dump-autoload - 避免用
files加载全局函数文件（如functions.php），虽然可行，但每次composer install都会重新生成 autoloader，容易漏掉新添加的.php文件；改用classmap包含整个目录更可靠 - 如果项目混用命名空间和传统类，
classmap和psr-4可共存，但注意路径不能重叠，否则 Composer 会随机选一个加载
vendor/autoload.php 引入时机和位置很关键
不是所有入口文件都适合直接 require_once 'vendor/autoload.php'。老项目常有多个入口（index.php、api.php、admin/index.php），容易漏引或重复引：
- 优先在最顶层公共引导文件（如
bootstrap.php或init.php）中引入，再由其他入口require它；避免每个.php都写一遍 - 如果入口文件在子目录（如
admin/），相对路径会出错，统一用__DIR__ . '/../vendor/autoload.php'或dirname(__DIR__) . '/vendor/autoload.php' - 上线前务必确认 Web 服务器工作目录是项目根目录，否则
vendor/autoload.php路径失效——Nginx 的root或 Apache 的DocumentRoot配错是高频故障点
为什么 composer install 有时不生效，而 require 却可以
本质区别在于： composer install 严格按 composer.lock 安装，而 composer require 会修改 composer.json 并更新 lock。旧项目迁移时常见陷阱：
- 团队协作中有人提交了
composer.json但忘了提交composer.lock，导致install报错 “Lock file does not contain required package” -
composer install在 CI/CD 或生产环境执行时，若没加--no-dev，可能装入开发依赖（如phpunit/phpunit），引发未预期的类冲突 - 本地
composer.json修改后没运行composer update就直接install，结果还是装的老版本——install不读json的变更，只认lock
最易被忽略的是 autoload 映射的缓存行为：classmap 生成后，Composer 不会自动感知新增的 PHP 文件，必须手动运行 composer dump-autoload；而很多人只记得 install 或 update，却忘了这一步，导致新加的类始终加载失败。
