composer本身不支持“按需拉取”，其设计目标是确定性依赖解析与本地可重现安装，install或update时必全量下载所有声明依赖；所谓云原生“按需”实为构建阶段裁剪（如--no-dev）、服务拆分composer.json、多阶段构建隔离vendor等分层控制策略。
Composer 本身不支持“按需拉取”（Lazy-Fetch）——它在 composer install 或 composer update 时就已把所有声明的依赖（包括 require 和 require-dev）全部下载、解压、安装到 vendor/。所谓“云原生环境下的按需拉取”，不是 Composer 原生能力，而是需要在构建流程、运行时或部署层做隔离与裁剪。
为什么直接用 Composer 无法实现 Lazy-Fetch
Composer 的设计目标是确定性依赖解析与本地可重现安装，其核心行为是：读取 composer.json → 锁定版本到 composer.lock → 下载全部包到 vendor/ → 生成自动加载器。它没有运行时动态加载包、条件性跳过某些 require、或只拉取某子集的机制。
-
composer install --no-dev只跳过require-dev，但所有require仍全量拉取 -
composer install --prefer-dist或--prefer-source影响的是获取方式，不是范围 - 即使使用
autoload-files或classmap，也改变不了 vendor 目录已存在全部包的事实
云原生场景下真正可行的“按需”路径
所谓“按需”，实际是指：构建阶段最小化 vendor、运行时只加载当前服务/模块真正用到的依赖。这需分层控制：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 构建时用
composer install --no-dev --optimize-autoloader --classmap-authoritative确保仅生产依赖 + 高效自动加载 - 将不同服务拆为独立
composer.json（例如api/composer.json、worker/composer.json），而非共用一个单体仓库的依赖树 - 在 CI/CD 中为每个服务单独执行
composer install，避免把 worker 用的amqp包打进 API 容器镜像 - 若必须共存于同一代码库，可用
composer create-project+ 子目录作为临时构建上下文，或借助composer config vendor-dir分离不同环境的 vendor
容易被忽略的兼容性陷阱
看似“按需”裁剪后，运行时报错往往不是因为缺包，而是自动加载或符号冲突没暴露出来：
- 多个服务共享代码但 vendor 分离时，
psr/log可能被不同版本重复引入，触发Class 'PsrLogLoggerInterface' not found（实际是 autoloader 未覆盖） - 用了
"autoload": {"psr-4": {"App\": "src/"}}，但某子模块依赖了src/Worker/下的类，而该模块的 composer.json 没声明 autoload —— 构建时不会报错，运行时才挂 - Docker 多阶段构建中，若在 builder 阶段运行
composer install后只COPY --from=builder vendor/，却漏掉了composer.lock或vendor/autoload.php的权限（如非 root 用户运行容器），会导致require_once(): Failed opening required 'vendor/autoload.php'
真正起作用的不是 Composer 的某个开关，而是你如何组织项目结构、划分服务边界、以及在构建流程中主动放弃“全量 vendor”的惯性思维。云原生里最重的不是拉取慢，而是镜像臃肿和冷启动延迟——而这两者，靠删掉不用的包比靠“懒加载”更直接有效。
