composer报错主因是php cli环境配置缺陷：path指向错误php.exe、必需扩展未启用、中文路径引发json解析失败、全局命令路径未加入path，需逐层验证修复。
php -v 能跑，但 composer 命令报错？先查 PATH 和 php.exe 路径
不是 Composer 没装好，而是系统根本找不到它调用的 php.exe —— 尤其在 Windows 下，XAMPP、PHPStudy、手动解压版 PHP 共存时，PATH 里写的路径可能指向一个没启用扩展、甚至根本不存在的 php.exe。
- 必须用完整路径验证 CLI 是否真可用：
C:\phpstudy_pro\Extensions\php\php-8.2.12\php.exe -v（替换成你实际路径），不能只信php -v - Windows 用户：打开「环境变量」，确认 Path 中添加的是 php.exe 所在目录（如
C:\phpstudy_pro\Extensions\php\php-8.2.12），不是php.exe文件本身 - macOS/Linux 用户：
which php输出路径要和php -i | grep "Loaded Configuration File"中的配置路径匹配；Homebrew 安装的 PHP 常在/opt/homebrew/bin/php，别漏加 - PATH 修改后，所有已打开的终端（CMD/PowerShell/VS Code 终端）都得关掉重开，否则不生效
composer install 卡在 “Resolving packages…” 或报 SSL 错误？缺扩展不是网络问题
Composer 在 CLI 模式下严重依赖 openssl、curl、zlib、mbstring 这几个扩展。Windows 默认禁用它们，Linux/macOS 包管理器安装的 PHP 可能没带全 —— 报错不是因为墙，而是 PHP 自己“手短”。
- 运行
php -m检查是否加载：openssl、curl、mbstring、zlib、json必须出现在列表里 - Windows：编辑对应版本的
php.ini（不是 php-cgi.ini），取消注释这几行：extension=openssl、extension=curl、extension=mbstring、extension=zip - Linux/macOS：Ubuntu/Debian 执行
sudo apt install php-cli php-mbstring php-xml php-zip php-curl php-openssl；macOS Homebrew 用户执行brew install php@8.2（自动带全扩展） - SSL 报错如
cURL error 60: SSL certificate problem，不是换镜像就能解决——需在 php.ini 中明确设置：curl.cainfo = "/path/to/cacert.pem"（cacert.pem 需自行下载并放指定位置）
中文路径或项目名导致 composer init 失败？绕过字符集陷阱
Composer v2+ 对路径和项目名中的非 ASCII 字符（尤其是中文）处理不稳定，composer init 交互式输入中文描述、作者名，或项目根目录含中文，极易触发 JSON 解析错误或文件写入失败。
-
composer.json是 UTF-8 编码的 JSON 文件，但 Windows CMD 默认是 GBK，直接交互输入中文会乱码 → 导致生成的文件末尾多出非法字符，后续composer install直接报Your requirements could not be resolved - 安全做法：全部用英文初始化 —— 项目名用
my-app，描述写My app，作者填邮箱即可；后续再手动编辑composer.json的中文字段（用 VS Code 等支持 UTF-8 的编辑器） - 项目根目录绝对不要含中文、空格、括号（如
C:\我的项目\、C:\project (v2)），改用C:\projects\myapp - Linux/macOS 用户若 locale 是
zh_CN.UTF-8，一般无问题；但若终端 LANG 设置为zh_CN.GBK，同样建议临时切到en_US.UTF-8再跑composer init
生产环境用 composer global require？别把 vendor/bin 路径当空气
很多人装完 Laravel Installer 或 PHPUnit 全局命令后，运行 laravel new myapp 报“命令未找到”，其实不是没装上，而是系统根本不知道去哪找 laravel.bat（Windows）或 laravel（macOS/Linux）。
-
composer global require laravel/installer安装的可执行文件默认放在：%APPDATA%\Composer\vendor\bin（Windows）或~/.composer/vendor/bin（macOS/Linux） - 这个路径和 Composer 自身的安装路径（如
C:\ProgramData\ComposerSetup\bin）完全无关，安装程序不会自动把它加进 PATH - 必须手动将该
vendor\bin目录加入系统 PATH（Windows 加到「用户变量」，避免权限问题；macOS/Linux 加到 shell 配置文件如~/.zshrc） - 验证方式：在新终端中运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认该路径存在；再运行ls -l ~/.composer/vendor/bin或查看%APPDATA%\Composer\vendor\bin是否真有对应文件
composer install 或 require 时突然断电。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
