不能用 apt install composer，因其版本陈旧（如2.2.22）、不兼容php 8.1+、路径不可写且无自动path配置；必须通过官方校验脚本安装composer 2.9.6，并执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/配置阿里云镜像。
Ubuntu 上直接 apt install composer 装出来的不是你要的 Composer，而是个版本卡死、无法升级、不兼容 PHP 8.1+ 的“残缺版”。必须绕过 APT，用官方脚本安装并配国内镜像，否则 composer install 会失败、autoload 会崩、self-update 会静默降级。
为什么不能用 apt install composer
Ubuntu 20.04/22.04 官方源里的 php-composer 包长期停留在 2.2.22 或更老版本（截至 2026 年 7 月仍普遍），它：
- 不支持
^2.5这类依赖约束写法，解析composer.json直接报错 - 调用的是系统默认 PHP（常是
/usr/bin/php），但你实际用的是php8.1或php8.3，导致create-project报 “Your requirements could not be resolved” -
/usr/share/php/composer/composer路径不可写，composer self-update永远 Permission denied - 没自动加
/usr/local/bin到$PATH，装完composer --version就报 command not found
如何安全安装 Composer 2.9.6（当前稳定版）
必须校验 SHA384 签名，否则 PHAR 文件可能被中间人篡改——后续所有依赖下载、autoload 生成都不可信。执行以下命令（可直接复制）：
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
验证：composer --version 应输出类似 Composer version 2.9.6。注意：如果提示 Command 'composer' not found，检查 echo $PATH 是否含 /usr/local/bin；若无，追加到 ~/.bashrc 并 source ~/.bashrc。
PHP 扩展缺失会导致 install 卡死或报错
composer --version 成功 ≠ 环境就绪。真正跑 composer install 时，常见崩溃点：
-
Class 'ZipArchive' not found→ 缺php-zip扩展 -
Class 'PharData' not found→ 缺php-phar -
json_encode() not found→ 缺php-json -
DOMDocument not found→ 缺php-xml
确认 PHP 主版本后装齐（例如 PHP 8.3 环境）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
sudo apt install php8.3-cli php8.3-zip php8.3-json php8.3-phar php8.3-xml unzip git
再用 php -m | grep -E "zip|phar|json|xml" 验证是否启用。如果仍报错，运行 php --ini 查看加载的 .ini 文件路径，确认对应 extension= 行未被注释。
配置阿里云镜像让 composer require 真正变快
全局镜像唯一生效方式只有一条命令，少一个字符都白配：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
关键点：
- 必须带
-g，否则写进当前项目composer.json，对其他项目无效 - 键名必须是
repo.packagist（不是repos.packagist或repositories.packagist.org） - URL 必须以
/结尾，否则请求发向packagist.org - 别用
sudo composer config -g，否则配置落到/root/.composer/config.json，普通用户根本读不到
验证是否生效：composer clear-cache && composer require monolog/monolog -vvv，在日志里搜 Downloading，看到 https://mirrors.aliyun.com/composer/packages.json 才算成功。如果还是 repo.packagist.org，说明项目级 composer.json 中的 "repositories" 字段覆盖了全局设置，删掉或加 "packagist": false 显式禁用。
最易被忽略的点：镜像配置后，composer update 速度提升明显，但如果你的项目 composer.json 里写了私有仓库或自定义 repositories，Composer 会优先走那些源，阿里云镜像只兜底公共包——这不是配置失效，是行为预期。
