composer命令提示“不是内部或外部命令”的根本原因是path环境变量未正确配置c:\programdata\composersetup\bin路径，需重装并勾选“add composer to the system path”，修改后必须重启终端生效。
composer命令提示“不是内部或外部命令”
这是 Windows 下最常见、也最容易解决的问题：根本原因就是系统找不到 composer.bat 这个可执行文件，本质是 PATH 环境变量没生效或压根没加进去。
- 打开 CMD，直接运行
echo %PATH%，搜索输出里有没有C:\ProgramData\ComposerSetup\bin（注意是ProgramData，不是AppData或Program Files） - 如果没出现，说明 Composer-Setup.exe 安装时 PATH 写入失败——重装是最省事的方案，官网下载最新
Composer-Setup.exe，安装时务必勾选 “Add Composer to the system PATH” - 如果出现了，但还是报错，运行
where composer，看返回的是不是C:\ProgramData\ComposerSetup\bin\composer.bat；如果不是，说明有其他同名文件（比如某个 PHP 目录下的旧版composer.bat）被优先匹配了，需要把C:\ProgramData\ComposerSetup\bin在系统环境变量中移到最顶部 - 改完 PATH 后，必须关闭所有已打开的 CMD/PowerShell/Git Bash/IDE 终端，再新开一个——Windows 命令行会缓存路径，不重启终端不会刷新
为什么不能用 php composer.phar 直接跑
能跑，但属于“临时救急”，不是日常开发该用的方式。它绕过了 PATH 和全局命令机制，埋下多个隐患。
- 每次都要写完整路径：
php C:\tools\composer.phar install，容易拼错、复制粘贴出错 - 杀毒软件常把刚下载的
composer.phar误判为可疑文件并静默删除，导致命令突然失效，错误信息还不明确 - PHP CLI 版本不一致时（比如你 PATH 里是 PHP 8.2，但项目要求 PHP 7.4），
php composer.phar会用错版本，引发兼容性问题，而全局composer命令在安装时已绑定正确 PHP 路径 - 某些 IDE（如 PhpStorm）的 Composer 集成功能只识别
composer命令，不认php composer.phar，自动补全、依赖分析等功能会失灵
验证是否真装好了：别只信 composer --version
composer --version 成功只说明命令能调起，不代表所有功能都正常。真正反映安装质量的是能否在任意目录完成一次最小闭环操作。
- 新建一个空文件夹，CMD 进入后执行：
composer init→ 回车跳过所有提示 → 最后生成composer.json - 立刻再执行：
composer require monolog/monolog—— 如果成功创建vendor/并下载包，说明 PHP、网络、镜像源、权限全部就绪 - 如果卡在 “Loading composer repositories with package information”，大概率是国内网络问题，此时应立即配置镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 若报错
file_put_contents(./composer.json): failed to open stream: Permission denied，说明当前目录是系统保护路径（如C:\Windows或桌面快捷方式指向的只读位置），换到用户目录下（如C:\Users\YourName\test）重试
PowerShell 里运行 composer 的几个细节
PowerShell 不是不能用，而是默认行为和 CMD 有细微差别，容易因习惯引发问题。
- 不要写
.\composer或./composer—— PowerShell 会优先查找当前目录下的composer.ps1（不存在）或composer.bat（可能没放对位置），反而绕过 PATH - 始终用无前缀的
composer，让系统按 PATH 解析，这是最稳定的方式 - 如果遇到
无法加载文件 xxx.ps1，因为在此系统中禁止运行脚本，说明你误打了composer.ps1，或者把别的工具脚本重命名成了composer.ps1；Composer 官方只提供.bat，不发布.ps1 - PowerShell 的 ExecutionPolicy 不影响
composer.bat执行，无需运行Set-ExecutionPolicy，强行改还可能带来安全风险
PATH 没写对、终端没重启、镜像没切、目录权限不对——这四点覆盖了 90% 的 Windows 下 Composer 启动失败场景。问题往往不在 Composer 本身，而在环境链路的某个环节被悄悄跳过了。
