关键是将composer.phar所在路径（如/usr/local/bin或c:\programdata\composersetup\bin）加入系统path环境变量，并重载配置或新开终端；否则会出现“command not found”错误。
composer 命令本身怎么全局可用
关键不是 Composer 多“高级”，而是 composer 这个命令能不能在任意目录下直接敲就运行。Windows 下它默认只是个 composer.phar 文件，Linux/macOS 下是软链接到 /usr/local/bin/composer ——但无论哪种，都依赖系统 PATH 能定位到它。
常见错误现象：'composer' is not recognized as an internal or external command（Windows）或 command not found: composer（macOS/Linux）。
- Windows：把
composer.phar所在目录（比如C:\tools\composer或C:\ProgramData\ComposerSetup\bin）加进系统环境变量Path，不是 PHP 目录，也不是用户目录 - Linux/macOS：执行
sudo mv composer.phar /usr/local/bin/composer，确保该路径已在$PATH中（通常默认包含） - 验证方式：新开终端，运行
which composer（macOS/Linux）或where composer（Windows），有输出即成功
composer global require 安装的工具为什么找不到命令
composer global require laravel/installer 成功后，laravel 命令仍报 command not found，90% 是因为全局 bin 目录没进 PATH，不是 Composer 没装好。
Composer 把可执行文件（如 laravel）软链接到 ~/.composer/vendor/bin/（Linux/macOS）或 %APPDATA%\Composer\vendor\bin（Windows），但它绝不会自动把这个路径加进系统环境变量。
- Linux/macOS：在
~/.zshrc或~/.bashrc末尾加export PATH="$HOME/.composer/vendor/bin:$PATH"，然后运行source ~/.zshrc - Windows：把
%APPDATA%\Composer\vendor\bin加入「系统属性 → 环境变量 → 用户变量 Path」，重启终端 - 如果改过
COMPOSER_HOME，比如设成D:\my-composer，那实际 bin 路径就是D:\my-composer\vendor\bin，PATH 必须同步更新 - 验证：运行
echo $PATH或echo %PATH%，确认对应路径已存在；再试laravel --version
COMPOSER_HOME 设错会导致什么静默失败
COMPOSER_HOME 是 Composer 全局行为的“根目录开关”，设错不报错，但所有全局操作都会悄悄走偏——比如认证失败、缓存不生效、global require 装的包找不到、self-update 失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
它必须是绝对路径，不能含 ~、$HOME、%USERPROFILE% 等展开符号，Windows 下也不能用点号路径（如 .\composer）。
- Linux/macOS：写进
~/.zshrc，例如export COMPOSER_HOME="/opt/composer"，然后source ~/.zshrc - Windows：用
setx COMPOSER_HOME "D:\my-composer"（CMD）或 PowerShell 命令，**必须重启终端** - 设完立刻验证：
composer config --global home输出应与你设置的一致 - 旧数据不会自动迁移：需手动复制
auth.json、config.json，并重新运行composer global install
哪些 config --global 设置真能跨项目生效
composer config --global 不是所有配置项都“真正全局”。有些只在有 composer.json 的项目里才参与决策，有些则从进程启动起就起效。
真正稳定生效的：影响网络、认证、基础行为的项，比如 github-oauth、http-basic、process-timeout、cache-dir。
- 镜像源设置有效：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ -
minimum-stability和prefer-stable在无composer.json的目录下运行composer require时**不生效**，它们只约束当前项目的依赖解析策略 - 平台配置（
platform）同理，只作用于install或update当前项目时的版本判断 - 验证是否生效：运行
composer config --list --global，看对应 key 是否出现在输出中且值正确
PATH 和 COMPOSER_HOME 是两条独立但常被混淆的线：前者决定“命令在哪能敲”，后者决定“全局配置和包存在哪”。改其中一个，另一个未必跟着动；两个都设错，问题就会叠加出现。
