多个项目不能共享vendor目录或composer.json，因autoload.php依项目配置动态生成；复用会导致类加载失败；唯一可复用的是包源（通过cache或path仓库+symlink），而非已安装结果。
多个项目不能共享 vendor 目录，也不能共用 composer.json —— 这不是限制，是 Composer 的运行前提。 试图绕过它，90% 的 Class not found、Method does not exist、autoload.php 找不到路径问题都源于此。
为什么不能把 vendor 目录软链或拷贝到多个项目下
vendor/autoload.php 不是通用加载器，它是根据当前项目 composer.json 中的 autoload 配置（PSR-4/PSR-0/classmap/files）动态生成的。Laravel 项目生成的 autoload.php 里注册的是 App\ 和 Illuminate\，Symfony 项目里却是 Symfony\Component\ 和 AppKernel。直接复用会导致命名空间映射完全错位。
常见错误现象：
-
require_once(): Failed opening required 'vendor/autoload.php'（路径对但内容失效） - IDE 能跳转、运行时报
Class not found（autoloader 注册了 A 项目的类，却在 B 项目上下文中执行） -
composer dump-autoload后部分类突然不可用（因重新生成时只读取当前项目配置）
真正可复用的只有「包源」，不是「已安装结果」
Composer 的缓存（~/.composer/cache/）默认复用 dist zip 包，这是唯一被官方支持的“共享”机制。你不需要做任何事，只要不删 cache，多次 composer install 就会跳过下载、直接解压。
想让多个项目用同一套私有代码，必须走标准包发布流程：
- 把共享逻辑单独建 Git 仓库，含完整
composer.json（含autoload和语义化 tag） - 各项目
composer.json中添加repositories指向该 Git 地址 - 执行
composer require "myorg/core:^2.3"—— 每个项目独立安装、独立 autoload
别用 composer global require 替代：global 的包装在 ~/.composer/vendor/，不会出现在任何项目的 vendor/autoload.php 中，use MyOrg\Core\Helper 必然失败。
本地开发时想实时调试共享库？用 path 仓库 + symlink
仅限开发环境，且必须通过 Composer 原生机制，而非手动 ln -s：
- 在主项目
composer.json的repositories中声明："repositories": [ { "type": "path", "url": "../my-shared-lib", "options": { "symlink": true } } ] - 然后
composer require "myorg/shared-lib:dev-main" - Composer 会在
vendor/myorg/shared-lib创建符号链接，指向源码目录
关键点：
-
"symlink": true必须显式写，否则默认复制文件，改源码不生效 - 路径支持相对路径或环境变量（如
${HOME}/code/my-shared-lib），方便团队协作 - 切勿手动在
vendor/下建 symlink：下次composer update会直接覆盖，且dump-autoload可能无法识别
离线或 CI 环境下如何避免重复下载
离线场景下，靠 cache 不够——因为 composer install 仍需访问网络校验或回退。稳妥做法是：
- 在有网机器上对每个项目执行
composer update --with-all-dependencies，确保composer.lock中每个dist条目都有url和shasum - 把整个
vendor/目录 +composer.lock一起打包交付 - 目标机上直接
rsync -a或解压覆盖，不运行composer install
如果只传 composer.lock 和压缩包，必须额外配置 artifact 仓库，且该配置对传递依赖无效 —— 这个细节极易被忽略，导致离线安装中途报 Could not find package。
