Composer全局安装Laravel Installer失败主因是PATH未配置、镜像失效、PHP CLI扩展缺失或权限异常；需手动添加bin路径至系统环境变量，切换腾讯云镜像，确认CLI模式下mbstring等扩展已启用，并修复~/.composer目录权限。
用 composer global require laravel/installer 安装 Laravel 安装器，表面简单，实际常卡在几个关键环节。问题不在于命令本身，而在于环境链路是否真正打通。
全局可执行文件找不到（最常见）
安装成功后运行 laravel 命令提示 command not found，不是没装上，而是系统根本“看不见”它。
- Composer 把
laravel二进制文件放在：
Linux/macOS 是~/.composer/vendor/bin，Windows 是%USERPROFILE%\AppData\Roaming\Composer\vendor\bin - 这个路径必须手动加入系统
PATH环境变量，否则终端无法识别该命令 - 验证方法：运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认路径已包含；再执行which laravel或where laravel看是否返回路径
网络与镜像源失效
安装过程卡在 Cloning、Downloading 或报 SSL operation failed、cURL error 7，基本是网络连通性或镜像配置问题。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
packagist.phpcomposer.com已停用；阿里云镜像地址已更新为https://mirrors.cloud.tencent.com/composer/（2026年起主流推荐） - 建议全局切换：运行
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 若仍失败，可临时关闭 HTTPS 强制校验（仅限开发机）：
composer config -g secure-http false
PHP CLI 扩展缺失或配置错位
报错如 Class 'Mbstring' not found、ext-pdo does not exist，或直接卡在第一步，往往不是 PHP 版本不够，而是 CLI 模式下扩展未启用。
- 网页端
phpinfo()显示有扩展 ≠ CLI 模式也加载了——XAMPP/WAMP/MAMP 用户尤其容易忽略这点 - 运行
php --ini查看 CLI 实际加载的php.ini路径，编辑该文件，确保开启：extension=mbstring、extension=openssl、extension=pdo、extension=tokenizer、extension=xml、extension=curl - Linux/macOS 用户若用包管理器安装 PHP（如 apt/brew），需单独安装扩展包，例如 PHP 8.2：
sudo apt install php8.2-mbstring php8.2-xml php8.2-sqlite3
权限不足或用户目录归属异常
安装时出现 Permission denied、failed to open stream 或写入 auth.json 失败，多因 ~/.composer 目录权限混乱。
- Linux/macOS：运行
sudo chown -R $USER:$USER ~/.composer和chmod -R 755 ~/.composer - Windows：以管理员身份运行终端，或检查当前用户对
%USERPROFILE%\AppData\Roaming\Composer是否有完全控制权限 - 避免使用
sudo composer global require，这会导致 bin 文件属主为 root，后续调用出错
