必须手动安装最新版Composer，因Debian仓库版（如1.10.22或阉割版2.2.x）不支持^2.5约束、PHP 8.2+、签名校验及platform-check，且缺扩展时静默失败；需卸载旧版、校验下载、设执行权限、加入PATH并配置国内镜像。
Debian 上装 Composer 不能靠 apt install composer，那装出来的是 1.10.x，连 ^2.5 依赖都解析不了，PHP 8.2+ 项目直接报错退出——它根本不是“不能用”，而是“假装能用，直到你 run composer install 卡在 Class 'ZipArchive' not found 才暴露”。必须手动下载、校验、设权、入 PATH。
为什么 apt install composer 在 Debian 上一定得卸掉
Debian 12（bookworm）仓库里自带的 composer 包版本是 2.2.x，但它是阉割版：禁用签名验证、硬编码过时镜像源、不支持 platform-check 块。更糟的是，它和官方 2.7+ 的行为不一致，比如对 conflict 规则静默忽略。一旦你本地有旧版残留：which composer 返回 /usr/bin/composer，就得先清干净：
sudo apt remove composersudo rm -f /usr/bin/composer-
hash -r（清 shell 命令缓存）
PHP 扩展缺一个，composer install 就会静默失败
Composer 2.5+ 强制要求 CLI 环境启用 zip、openssl、json、mbstring、phar、xml 六个扩展，缺任何一项都会在 install 阶段报 Class 'ZipArchive' not found 或直接卡住。别信“php -v 能跑就行”——要查 CLI 模式实际加载了哪些：
-
php -m | grep -E "zip|openssl|json|mbstring|phar|xml"—— 输出必须六项全在 - 缺
zip？sudo apt install php-zip - 缺
mbstring？sudo apt install php-mbstring - 改完记得重启 PHP-FPM（如果用了）或重开终端
composer --version 报 “Permission denied” 或 “command not found” 怎么快速定位
这两个错误看着像一回事，其实是两个独立问题叠加的结果：
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。
-
Permission denied→ 文件没执行权限：ls -l /usr/local/bin/composer看输出是不是-rw-r--r--；补权限：sudo chmod +x /usr/local/bin/composer -
command not found→/usr/local/bin不在当前$PATH里：echo $PATH | grep -o '/usr/local/bin'若无输出，说明路径没加载；临时修复：export PATH="/usr/local/bin:$PATH"；永久生效需写入~/.bashrc（用户级）或/etc/profile（系统级） - 注意：Docker 容器或 systemd service 启动的进程通常不读
~/.bashrc，这类场景必须确保/usr/local/bin已在系统默认 PATH 中
国内网络下不配镜像源，composer create-project 基本必超时
默认走 packagist.org，DNS 解析慢 + 连接不稳定，create-project 经常卡在 “Downloading laravel/framework” 或 “Resolving packages”。全局配置阿里云镜像只需一行：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否生效：composer config -g repo.packagist 应输出 https://mirrors.aliyun.com/composer/。如果后续遇到镜像同步延迟（比如新包发布后几小时才同步），可临时切回官方源：composer config -g --unset repos.packagist。
真正容易被忽略的点是：PATH 和权限问题在最小化安装的 Debian（比如 debian:bookworm-slim Docker 镜像）里几乎必然出现，而且不会报明确错误，只会让 composer 命令“不存在”或“拒绝执行”——查的时候别只盯着下载步骤，先 ls -l /usr/local/bin/composer && echo $PATH 两行命令就能定死因。
