不能用 apt/yum 安装 Composer，因其仓库版本多为过时的 1.x，不支持 PHP 8.2+、缺失安全校验且无法升级至 2.7+；必须手动下载校验后安装，并配置国内镜像源。
为什么不能用 apt install composer 或 yum install composer
因为系统仓库里的 composer 几乎全是 1.x 版本（比如 1.10.22），它不支持现代 PHP 项目必需的语法：比如 platform-check、conflict 块，也跑不动 PHP 8.2+ 的类型声明；更关键的是，它默认跳过包签名校验，且无法执行 composer self-update --stable 升级到 2.7+。你装完一跑 composer install 就卡在 class ZipArchive not found 或直接报 Allowed memory size exhausted，不是环境问题，是工具本身过时了。
- 运行
composer --version输出带1.开头？立刻卸载：sudo apt remove composer（Ubuntu）或sudo yum remove composer（CentOS） - 卸载后还出现
/usr/bin/composer？说明残留未清：sudo rm /usr/bin/composer - 别信“装了就行”，版本错 = 后续所有依赖解析、锁文件生成、CI 构建全不可靠
必须手动安装：下载 → 校验 → 移动 → 设权
官方唯一推荐方式，核心就四步，漏掉校验或权限，后面会出无声故障——比如命令能识别但 composer install 报 Permission denied，或下载包时突然中断没提示。
- 先确保 PHP 扩展就位：
sudo apt install -y php-cli php-zip php-json php-mbstring php-xml php-phar（Ubuntu）；CentOS/RHEL 8+ 用sudo dnf install -y php-cli php-zip php-json php-mbstring php-xml php-phar - 下载并校验（防中间人攻击）：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" HASH=$(curl -sS https://composer.github.io/installer.sig) php -r "if (hash_file('sha384', 'composer-setup.php') === '\$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;" - 校验通过后安装：
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer - 删临时文件：
rm composer-setup.php；补执行权限（某些系统不自动设）：sudo chmod +x /usr/local/bin/composer
composer --version 报 command not found 或 Permission denied 怎么办
这不是 Composer 没装好，而是 shell 找不到它，或当前用户无权执行——90% 的“装不上”其实是路径或归属问题。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
command not found：检查echo $PATH是否含/usr/local/bin；不含就加：echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc -
Permission denied：大概率是某次误用sudo composer install，导致vendor/、composer.lock或~/.composer/cache/被设为 root 属主。别chmod -R 777，先查归属：ls -ld vendor/ composer.lock $(composer config --global cache-dir) - 修复归属：
sudo chown -R $USER:$USER vendor/ composer.lock $(composer config --global cache-dir) - 永远用普通用户执行
composer命令；sudo是所有后续权限混乱的起点
装完第一件事：配国内镜像源
不配的话，composer create-project 或 require 会卡几十秒甚至超时，尤其在 CI/CD 环境里直接失败。
- 阿里云镜像（稳定可用）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 清华源（备选）：
composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意：该地址已停用，改用https://packagist.org或阿里云） - 验证是否生效：
composer config -g --list | grep repo，应看到对应 URL
别跳过校验步骤，也别省掉设权和配镜像——这三步漏一个，后面花两小时 debug 都未必定位到根因。
