composer install 执行前必须确认 composer.lock 存在，否则会退化为不可控的 update 行为；需检查文件是否被 .gitignore 排除、php 版本与扩展是否匹配、autoload 配置是否正确且已执行 dump-autoload。
composer install 执行前必须确认 composer.lock 是否存在
没有 composer.lock 文件时，composer install 会退化成 composer update 行为——它会重新解析 composer.json 并安装最新兼容版本，结果不可控，且与他人环境不一致。
常见错误现象：
- 刚 clone 项目就跑
composer install，报错或装出奇怪版本 - CI 构建失败，提示 “package not found”，但本地
composer update能过
你应该做的：
- 用
ls -la | grep composer.lock确认文件真实存在（不是被.gitignore漏掉） - 如果不存在，别硬敲
install，而是先问清楚：这是全新项目？还是别人忘了提交 lock 文件？ - 全新项目应走
composer install→ 生成 lock → 提交 lock 到 Git 的标准流程
PHP 版本和扩展不匹配是 install 失败最常见原因
composer install 不是“装包”，它是按 composer.lock 里写死的版本和平台约束做精确还原。一旦 PHP 版本、扩展缺失或 config.platform 配置与实际不符，就会直接报 Your requirements could not be resolved ——这不是依赖冲突，是环境不达标。
排查要点：
- 运行
php -v和php -m | grep -E "mbstring|xml|curl|openssl"，核对是否满足 lock 文件中任一包的php或ext-xxx要求 - 检查
composer.json顶部是否有"config": {"platform": {...}}，比如写了"php": "8.2.10"，但你本地是8.2.9，也会失败 - 用
composer diagnose快速标出缺失扩展（它比看报错更准）
别急着加 --ignore-platform-reqs：装完大概率在 php artisan serve 或 vendor/autoload.php 加载时崩溃。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
国内网络下卡在 “Loading composer repositories” 怎么办
这不是命令问题，是默认源 packagist.org 在国内访问不稳定导致的超时。你会看到命令停在那不动，十几秒甚至几分钟没响应。
正确做法是全局配置阿里云镜像：
- 执行
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repos.packagist应输出该 URL - 避免手动改
composer.json里的repositories字段——容易和团队配置冲突
如果已卡住，Ctrl+C 中断后重试；不要反复敲命令，缓存没清干净反而更慢。
install 成功后类 still not found？autoload 没生效是真凶
composer install 成功 ≠ 项目能跑。90% 的 “Class not found”、“failed to open stream” 错误，根源不在依赖没装，而在自动加载没注册或路径错位。
关键检查点：
- 确认
vendor/autoload.php被入口文件（如index.php或artisan）真实引入，且路径正确（不是../vendor/autoload.php写成../../vendor/autoload.php） - 检查
composer.json的autoload配置是否手动加了 PSR-4 映射，比如"App\": "src/"，且src/目录真实存在、命名空间末尾有反斜杠 - 运行
composer dump-autoload -o强制重生成映射（尤其换过 PHP 版本或改过 autoload 配置后）
最容易被忽略的一点：修改 composer.json 的 autoload 后，install 不会自动触发 dump-autoload，必须手动补这一步。
