composer命令找不到需先确认path配置：windows需重启终端，macos用brew安装，linux用curl安装并移动至/usr/local/bin；国内用户应配置阿里云镜像源并清理vendor与composer.lock后重装。
composer 命令找不到？先确认它真在系统 PATH 里
不是 Composer 装不了，是终端根本找不到它。Windows 用户双击 Composer-Setup.exe 后必须新开一个 CMD 或 PowerShell 窗口再试；macOS 用 brew install composer 最省事；Linux 推荐这行命令装完就可用：
curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer
验证不能只跑 composer --version，还得加一句：
composer diagnose
如果卡在 Downloading https://packagist.org/packages.json，说明 PATH 没问题但网络不通——这是下一步要解决的。
国内运行 composer install 卡住？换镜像源别只改一半
卡在 Loading repositories 是墙导致的，不是你网坏了。全局换阿里云镜像最常用：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
但要注意几个坑：
- 别手误写成
repos.packagist（多一个s），这种拼写错误不报错，但配置无效 - 宝塔或 CI 脚本里跑这条命令，很可能写进了 root 用户配置，而实际执行的是
www或runner用户，得切到对应用户再配一次 - 更稳的做法是进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/—— 它会直接写进composer.json，提交 Git 后所有人行为一致
改完记得删掉 vendor 和 composer.lock 再重跑 composer install，否则旧 lock 文件里的 hash 可能和镜像元数据不匹配。
require_once 'vendor/autoload.php' 报错？路径和顺序比语法更重要
报 Class not found 或 failed to open stream，90% 是这两件事没做对：
- 入口文件（比如
index.php）第一行就必须是：require __DIR__ . '/vendor/autoload.php';—— 用__DIR__，别用./vendor/autoload.php或vendor/autoload.php - 这行代码必须放在最顶上，前面不能有任何输出、
session_start()、header()，甚至不能有空格或 BOM - Web 和 CLI 下相对路径行为不一致，所以永远别依赖当前工作目录，只认
__DIR__
漏掉这行，IDE 可能不提醒，但运行时直接 fatal error；写错路径，PHP 就报找不到文件。
composer install 和 composer require 到底该用哪个？
新手最容易混用，结果团队协作出问题：
-
composer install：只读composer.lock，精确还原依赖版本 —— 部署、CI、同事拉代码后必须用它 -
composer require vendor/package：往composer.json写新包，并安装兼容的最新版 —— 仅用于本地开发加功能 - 已有项目里乱跑
composer require，会更新composer.lock，可能引发线上构建失败 -
composer install找不到composer.lock时，会自动退化成composer update行为 —— 这点常被忽略，导致本地和线上环境不一致
真正容易被忽略的是：autoload 路径写对了、镜像配好了、命令也跑通了，但只要 composer.lock 没提交到 Git，协作就永远存在隐患。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
