composer install卡在0%或无进度条，本质是composer 7+异步下载机制后台运行但不输出进度，属设计行为而非bug；加-vvv确认是否真卡住，可设composer_disable_parallel=1禁用并行或配置"preferred-install": {"*": "source"}跳过zip解压。
Mac上composer install卡在0%或没进度条，根本不是网络慢
进度条不动，大概率是 Composer 7+ 默认启用的异步下载机制在后台干活，但不输出实时进度——尤其遇到大包（如 laravel/framework）或磁盘 I/O 慢时，看起来就像“假死”。
这不是 bug，是设计行为。你看到的“卡住”，其实是它正在后台解压 ZIP、校验 SHA256、写入 vendor，只是没告诉你。
- 先加
-vvv看真实日志：composer install -vvv 2>&1 | grep -E "(Downloading|Extracting|Writing)"，确认是否真停了 - 临时禁用并行：设环境变量
COMPOSER_DISABLE_PARALLEL=1再跑命令，进度会变慢但可感知 - 跳过 ZIP 下载，改用源码安装：
"preferred-install": {"*": "source"}加进composer.json，避免解压瓶颈 - Homebrew 用户注意：
php@8.2默认不替换系统/usr/bin/php，php -v可能还是老版本，别信 alias
Mac Homebrew装了多个PHP，但composer install还是报PHP版本不满足
报错 This package requires php ^8.2 but your PHP version (7.4.33) does not satisfy that requirement，说明 Composer 正在用你终端里当前 php 命令指向的版本做校验——而 Homebrew 安装的 php@8.2 很可能没被激活，或者 which composer 指向的是 shell 脚本封装的命令，开头是 #!/usr/bin/env php，最终仍走 $PATH 里第一个 php。
- 查真实 PHP 版本：
php -v和file $(which composer)，如果输出含 “shell script”，再看head -n1 $(which composer)的 shebang 行 - 最稳写法（macOS/Homebrew）：
php@8.2 -d memory_limit=-1 /opt/homebrew/bin/composer.phar install，-d参数必须紧贴 PHP 路径后、composer.phar前 - 别用
alias composer='php@8.2 composer'：Git hooks、Makefile 等非交互环境里基本失效 - CI 脚本中务必前置
php -v打日志，否则你根本不知道底层在用几
config.platform.php 在 Mac 上设了却还是运行时报 syntax error
config.platform.php 是“编译期欺骗”，只影响 composer install 阶段的依赖解析，完全不改变运行时能力。你在 PHP 7.4 的 Mac 上设 "platform": {"php": "8.2.0"}，Composer 会选 PHP 8.2 兼容的包，但生成的 vendor/autoload.php 里若含 match 或 readonly，PHP 7.4 运行时照样报 ParseError: syntax error, unexpected token "match"。
- 适用场景：CI 构建部署包，目标环境是 PHP 8.2，但构建机只有 PHP 7.4 → 设 platform +
composer update --lock - 禁用场景：本地开发想直接跑 Laravel 11（要求 PHP 8.2+）→ platform 不会让 PHP 7.4 突然支持新语法
- 设完必须重生成锁文件：
composer update --lock，否则composer.lock里还是旧版本包信息 - 别提交到团队仓库：队友 PHP 版本不一致时，有人 install 成功，一跑就崩
中文路径或终端 locale 导致 composer install 失败或乱码
Mac 终端默认 locale 是 en_US.UTF-8，但某些 Homebrew 安装的 PHP 或 Composer 插件（比如某些自定义 installer）在处理含中文路径的项目时，会因字符编码不一致导致 file_put_contents() 失败、autoload 生成异常，甚至静默退出。
- 检查当前 locale：
locale，确保LANG和LC_ALL是 UTF-8（如zh_CN.UTF-8或en_US.UTF-8） - 临时修复：
export LC_ALL=en_US.UTF-8再跑composer install - 项目路径含中文？尽量避免。Composer 本身不禁止，但部分依赖包的脚本（尤其是 post-install-cmd）可能调用系统命令（如
git、unzip）时出问题 - Homebrew 安装的 PHP 默认不带
mbstring扩展，中文路径操作易出错，确认已启用：php -m | grep mbstring
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
