必须用官方脚本安装Composer 2.9.6并配阿里云镜像，禁用apt安装；需装齐php-zip、php-phar、php-xml、php-mbstring等扩展，且确保PHP CLI版本与项目一致。
直接运行 composer install 很可能失败——不是命令不存在，而是环境没配齐、镜像没切、PHP 扩展缺位，甚至 composer 本身压根就不是你要的那个版本。
为什么 composer install 会卡住或报错
常见现象包括：Loading composer repositories with package information 卡住不动、Class 'ZipArchive' not found、Your requirements could not be resolved、Permission denied 或直接提示 command not found。根本原因不是项目问题，而是 Ubuntu 系统级配置没对齐：
-
apt install composer安装的是 2.2.22 或更老的版本（截至 2026 年 8 月仍普遍），不支持 PHP 8.1+，也不识别^2.5这类约束写法 - 系统默认 PHP 路径（如
/usr/bin/php）和你实际用的 PHP 版本（如php8.3）不一致，导致依赖解析失败 - 缺少必要扩展：
php-zip、php-phar、php-xml、php-mbstring缺一不可，否则解包、autoload、依赖扫描全崩
确保 composer 是官方 2.9.6 且路径可用
Ubuntu 不能靠 apt，必须走官方校验安装流程。执行以下命令（可直接复制）：
EXPECTED_CHECKSUM="$(curl -sS https://composer.github.io/installer.sig)"
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
ACTUAL_CHECKSUM="$(php -r "echo hash_file('sha384', 'composer-setup.php');")"
if [ "$EXPECTED_CHECKSUM" != "$ACTUAL_CHECKSUM" ]; then
echo 'Integrity check failed' >&2
rm composer-setup.php
exit 1
fi
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
rm composer-setup.php
验证是否生效：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer --version，输出应为Composer version 2.9.6 - 若提示
command not found，检查echo $PATH是否含/usr/local/bin；若无，追加到~/.bashrc并执行source ~/.bashrc - 确认
which php输出路径与php -v显示的版本一致（比如都是php8.3）
必须提前装好 PHP 扩展并配置国内镜像
composer --version 成功 ≠ composer install 能跑。Ubuntu 默认 PHP 安装极简，以下扩展缺一不可：
sudo apt install php-zip php-phar php-xml php-mbstring php-curl- 装完重启 CLI 环境（关掉终端重开，或
hash -r） - 立即配置阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 如果项目用了私有包或特殊平台要求，可临时允许绕过检查：
COMPOSER_ALLOW_SUPERUSER=1 COMPOSER_ALLOW_PLATFORM_REQS=1 composer install
运行 composer install 前的最小检查清单
别跳步骤，每项都影响成败：
- 当前目录下存在
composer.json和composer.lock（没有lock文件时，install会退化为update，行为不可控） - 运行
php -m | grep -E 'zip|phar|xml|mbstring'，确保全部列出 - 执行
composer diagnose，它会报出路径、镜像、权限等真实问题，比猜错因高效得多 - 如果服务器在内网或代理后，确认
curl -I https://mirrors.aliyun.com/composer/能通；不通则需设http_proxy或换镜像源
最常被忽略的点：即使所有命令都显示“成功”，composer install 仍可能因 PHP 扩展加载顺序或 opcache 缓存旧配置而失败。遇到诡异卡顿，先 php -d opcache.enable=0 composer install 排查。
