laravel命令提示command not found是因全局安装路径未加入path或权限错误;需检查composer global list、确认bin路径、添加至shell配置并source,禁用sudo安装,修复权限及缓存。

laravel 命令在终端里提示 command not found
说明 laravel 全局命令没装好,或者装了但不在系统 PATH 里。这不是 Laravel 项目的问题,而是 Composer 全局 bin 目录没被 shell 识别。
- 先确认是否真装了:
composer global list | grep laravel/installer,有输出才表示已安装 - 检查 Composer 全局 bin 路径(通常是
~/.composer/vendor/bin或~/.config/composer/vendor/bin),用ls -la ~/.composer/vendor/bin/laravel看文件是否存在 - 把该路径加进 shell 配置(
~/.zshrc或~/.bashrc):一行写export PATH="$HOME/.composer/vendor/bin:$PATH"(路径按你实际的改) - 重载配置:
source ~/.zshrc(或对应 shell 文件),再试laravel --version
laravel new 项目时报错:Could not find package laravel/installer
这是 Composer 没从全局源拉到 laravel/installer,常见于国内网络或 Composer 镜像配置异常。
- 手动安装一次:
composer global require laravel/installer,别加--dev,必须是全局 - 如果卡住或报
failed to open stream,先换源:composer config -g repo.packagist composer https://packagist.phpcomposer.com(或阿里云镜像) - 装完后执行
composer global dump-autoload,避免 autoloader 缓存导致命令不可见 - 注意 PHP 版本:Laravel 11 要求 PHP 8.2+,
php -v确认版本,低版本装laravel/installer:^4(对应 Laravel 9/10)
Windows 上 laravel 命令能运行但创建项目失败:The system cannot find the path specified
本质是 Windows 的 .bat 包装器找不到 PHP 可执行文件路径,尤其当你用 XAMPP、WAMP 或独立 PHP 安装时。
PHP中文网提供Laravel 13.2.0版本下载,Laravel框架 是基于 PHP 8.3+ 的高性能框架,官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索,支持属性驱动开发与队列路由,大幅提升开发效率。相比旧版,13.2.0 优化了缓存 TTL 管理与实时通信,无需 Redis 即可横向扩展。作为现代 Web 开发首选,它兼顾安全与极速体验,助您快速构建企业级应用。
- 查
php.exe实际位置,比如C:\xampp\php\php.exe,然后运行:composer global config bin-dir确认 bin 目录 - 进该 bin 目录,打开
laravel.bat,检查第一行是否指向正确 php 路径(如@php "%~dp0/../laravel/installer/bin/laravel")——它依赖环境变量PHP_BINARY或默认找系统 PATH 里的 php - 更稳的做法:不用
laravel new,改用 Composer 创建:composer create-project laravel/laravel your-project-name - PowerShell 用户注意:某些杀毒软件会拦截
.bat执行,临时禁用或换 CMD 再试
装了 laravel 命令但 laravel new 报错:file_put_contents(/path/to/app/...): failed to open stream
权限问题,尤其是 Linux/macOS 下用 sudo composer global require 导致全局 bin 或缓存目录属主错乱。
- 别用
sudo装全局包,改用:composer global require laravel/installer --no-plugins - 修复权限:
sudo chown -R $USER:$USER ~/.composer(macOS/Linux);Windows 则检查目标盘是否启用“只读”或 BitLocker 加密 - 清掉旧缓存:
composer clear-cache,再laravel new myapp - 如果还报路径错误,关掉 IDE(如 PHPStorm)或编辑器对项目目录的占用,它们常锁文件
最常被跳过的其实是 shell 配置重载和权限归属——装完不 source,或随手 sudo composer,后面所有问题基本都从这里长出来。










