每个 php 项目必须有独立的 composer.json 和 vendor/ 目录，不可共享；composer global 仅适用于 cli 工具；包缓存自动复用 dist 文件，无需手动同步 vendor；autoload 冲突多源于映射错误或 ide/opcache 缓存未清理。
多个项目共用一个 composer.json？别这么干
不能。每个 PHP 项目必须有自己独立的 composer.json，这是 Composer 的设计前提——它按项目目录做依赖隔离，不是全局包管理器。强行共享会导致 autoload 冲突、版本锁定错乱、vendor/autoload.php 路径失效，甚至运行时类找不到。
常见错误现象：Class not found、require_once(): Failed opening required 'vendor/autoload.php'、composer install 报 Package ... has a dependency on ... which does not match your minimum-stability（因不同项目 stability 设置不一致）。
- 每个项目根目录下必须有独立的
composer.json和vendor/ - 不要把多个项目的
vendor/目录软链到同一位置 - 避免在父目录放通用
composer.json然后用--working-dir切换——这会让autoload生成逻辑混乱，IDE 和 CLI 都可能误判上下文
composer global 适合装什么，不适合装什么
composer global 是唯一真正“全局”的机制，但它只该用于命令行工具（CLI tools），不是项目依赖的捷径。
使用场景：装 phpunit/phpunit、laravel/installer、deployer/deployer 这类你希望在任意路径下直接敲命令就能用的工具。
容易踩的坑：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 装项目级依赖（如
monolog/monolog）进 global：会导致项目require时版本冲突，且autoload不生效——global 包不会自动加入当前项目的 autoloader - 忽略
COMPOSER_HOME路径权限问题：Linux/macOS 下若用sudo composer global，后续普通用户执行会报Permission denied写入~/.composer/vendor/ - PHP 版本不匹配：global 包是按当前 CLI PHP 版本安装的，切换 PHP 小版本（如 8.1 → 8.2）后可能需重新
global update
怎么让多个项目复用已下载的包（加速 install）
Composer 默认用 cache 机制复用 zip 包和 dist 文件，但这个 cache 是全局共享的，不需要你手动干预——只要没清过 ~/.composer/cache/，重复 composer install 就会跳过下载。
关键点在于：cache 复用的是 dist 包（zip/tar），不是 vendor/ 目录本身。想跳过解压重建，得靠 composer install --prefer-dist（默认行为），而不是 --prefer-source。
- 确认 cache 是否生效：运行
composer config --global cache-dir，检查该路径磁盘空间是否随多次 install 增长 - CI 环境中常禁用 cache，此时应显式加
--no-cache避免误读本地缓存；本地开发则完全不用管 - 不要用硬链接或 rsync 同步
vendor/：不同项目composer.lock的哈希、平台配置、autoload 规则都不同，复制过去大概率导致Class not found或Failed to open stream
多项目下 autoload 冲突的真实来源
冲突几乎从不来自 Composer 本身，而来自开发者手动修改了 vendor/autoload.php、或在多个项目里用了相同命名空间但不同路径映射、或在 composer.json 中写了错误的 psr-4 映射（比如漏掉末尾反斜杠）。
典型错误现象：Cannot declare class X, because the name is already in use，或某个类在 A 项目能加载，在 B 项目报 Class not found。
- 检查每个项目的
composer.json中autoload段：确保psr-4的 namespace 与实际目录结构严格对应，例如"App\": "app/"，不是"App": "app/" - 运行
composer dump-autoload --optimize后，打开vendor/composer/autoload_psr4.php看生成的映射是否符合预期 - 如果项目间有私有包（如公司内部 SDK），必须通过
repositories声明源，并统一用version锁定，避免不同项目 require 同一包的不同分支导致 autoload 表不一致
最麻烦的其实是 IDE 缓存和 opcache —— 改完 composer.json 后，记得清 IDE 的 index、重启 PHP-FPM 或 CLI opcache（opcache_reset()），否则“明明改对了却还是报错”这种事每天都在发生。
