composer命令未找到主因是安装路径未加入$path环境变量，需检查并添加~/bin或/usr/local/bin到~/.bashrc或~/.zshrc，再source生效，同时确保composer文件具有可执行权限。
Composer 命令未找到，不是没装好，大概率是 composer 可执行文件没进系统 $PATH —— 重点查家目录下的安装路径是否被正确加入环境变量。
为什么 composer 装完还是报“command not found”
官方推荐的安装方式（php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" 等）默认把 composer.phar 放在当前目录，或手动移到 ~/bin/composer，但系统根本不知道这个位置。Shell 启动时只搜索 $PATH 里列出的目录，不会自动扫描家目录子文件夹。
-
which composer返回空、command -v composer无输出 → 确认不在$PATH -
ls -l ~/bin/composer或ls -l /usr/local/bin/composer能看到文件 → 说明已存在，只是路径没生效 - 新终端打不开命令，但老终端能用 → 很可能是只改了某次会话的
PATH，没写入 shell 配置文件
快速验证并修复 $PATH 配置
先确认你把 composer 放哪了：常见位置是 ~/bin/composer（用户级）或 /usr/local/bin/composer（系统级）。再检查它是否在 $PATH 中：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
echo $PATH，看输出里有没有/home/用户名/bin或/usr/local/bin - 如果没出现，就补进去：编辑
~/.bashrc（Bash 用户）或~/.zshrc（Zsh 用户） - 在文件末尾加一行：
export PATH="$HOME/bin:$PATH"（若放在~/bin）或export PATH="/usr/local/bin:$PATH"（若放系统目录） - 保存后执行
source ~/.bashrc或source ~/.zshrc立即生效
注意 composer 文件权限与可执行性
即使路径对了，composer 本身没执行权限也会失败。尤其从 curl 下载的 .phar 文件默认不可执行：
- 检查权限：
ls -l ~/bin/composer，正常应含x（如-rwxr-xr-x） - 若没有，运行
chmod +x ~/bin/composer - 别用
php composer.phar代替composer命令——这绕过了 PATH 机制，也丧失全局调用能力 - Mac 用户若用 Homebrew 安装过 PHP，可能有多个
php版本，确保composer调用的是你期望的那个（which php可查）
Windows WSL 或 Docker 环境下容易漏掉的点
WSL 用户常把 composer 装在 Windows 的 C:\Users\xxx\bin，但 Linux 子系统默认不挂载该路径到 $PATH；Docker 构建时若用 apt install composer，新版 Debian/Ubuntu 默认装的是 composer1，得手动 alias 或重命名：
- WSL：坚持用 Linux 路径（如
/home/xxx/bin），别跨系统引用 Windows 文件 - Docker：
ln -s /usr/bin/composer1 /usr/local/bin/composer或在Dockerfile中用官方安装脚本 - CI 环境（GitHub Actions 等）：每次运行都是干净环境，必须在
steps中显式安装并配置 PATH，不能依赖本地习惯
最常被忽略的是：改完 ~/.bashrc 没 source，或者以为重启终端就行，结果用的是图形界面启动的终端（可能读的是 ~/.profile 而非 ~/.bashrc）。多一句 echo $PATH 就能省半小时排查时间。
