必须带composer.lock文件，只复制composer.json无效；composer install严格按lock还原依赖，缺失lock会导致环境不一致、版本漂移甚至运行报错。
交接项目必须带 composer.lock 文件
只复制 composer.json 是无效的。你拿到的项目如果没 composer.lock，composer install 会按 composer.json 重新解析依赖树，结果很可能和原环境不一致——比如 Laravel 10.42 的某个 patch 版本被作者撤回，而新解析出来的版本是 10.41，但你的代码里用了 10.42 才加的 withTrashed() 方法，直接报错。
实际交接时，务必确认以下三样文件/目录已完整同步：
-
composer.lock（核心，不能少） -
vendor/目录可选（若带过来能跳过下载，但需注意权限和平台兼容性） -
.env.example或已配置好的.env（否则php artisan key:generate后仍无法启动）
生产环境部署必须用 composer install --no-dev --optimize-autoloader
composer update 在交接场景下是危险操作：它会忽略 composer.lock，强行重算依赖，哪怕只是把 monolog/monolog 从 3.5.0 升到 3.6.0，也可能因移除某个内部方法导致日志写入失败，而这种问题在线上才暴露。
正确命令只有这一条：
composer install --no-dev --optimize-autoloader
含义很明确：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
--no-dev：跳过require-dev中的包（如 PHPUnit、php-cs-fixer），避免生产机装一堆调试工具 -
--optimize-autoloader（或简写-o）：生成静态类映射，减少file_exists()调用，加载速度提升明显 - 不加
--ignore-platform-reqs—— 如果 PHP 版本或扩展不匹配，宁可报错，也不要静默降级或跳过
宝塔面板上执行前必须检查三件事
很多交接失败不是因为命令写错，而是 PHP CLI 环境没对齐。宝塔默认不把 PHP 二进制加进系统 PATH，也不开放关键函数。
执行 composer install 前，先在宝塔【终端】里逐项验证：
- 运行
php -v，确保输出的是你站点实际使用的 PHP 版本（比如PHP 8.0.30）；如果报command not found，得手动建软链：ln -sf /www/server/php/80/bin/php /usr/local/bin/php - 运行
php -m | grep -E "openssl|tokenizer"，两个模块必须存在，否则 Composer 启动即失败 - 进【PHP 管理】→ 选对应版本 → 【禁用函数】列表里，确认
proc_open、putenv、pcntl_signal这三个已**完全删除**（不是取消勾选），删完点【重载配置】
离线环境还原 vendor 必须加 COMPOSER_DISABLE_NETWORK=1
有些项目交接发生在内网或断网服务器，这时不能指望 composer install 自己联网下载。即使你把整个 vendor/ 目录拷过去了，直接运行 composer install 仍会尝试访问 https://repo.packagist.org/packages.json，然后卡住或报错。
正确做法分两步：
- 先设环境变量彻底断网：
COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader - 再强制重建自动加载：
composer dump-autoload -o
注意：--no-autoloader 是为了跳过 install 阶段的 autoload 生成，避免因路径或权限问题失败；dump-autoload -o 才是真正生成可用的加载器。少了这一步，require 'vendor/autoload.php' 一定报错。
