laravel命令报command not found主因是PATH未包含Composer全局bin路径；需确认laravel/installer已全局安装、检查~/.composer/vendor/bin下文件存在、将该路径加入shell配置并重载，再验证laravel --version。
遇到 Laravel 命令行执行报错，别急着重装或改代码。核心思路是：先确认命令本身是否可用 → 再看报错类型 → 最后定位到具体环节。多数问题其实出在环境配置或路径权限上，而非项目逻辑。
检查 laravel 全局命令是否真正生效
运行 laravel --version 报 command not found，说明系统根本没识别这个命令：
- 执行 composer global list | grep laravel/installer，确认安装成功
- 查 Composer 全局 bin 路径（常见为
~/.composer/vendor/bin或~/.config/composer/vendor/bin），运行 ls -la ~/.composer/vendor/bin/laravel 看文件是否存在 - 若存在，把该路径加进 shell 配置（如
~/.zshrc）：export PATH="$HOME/.composer/vendor/bin:$PATH" - 执行 source ~/.zshrc 重载，再试 laravel --version
laravel new 创建项目失败的典型原因
提示 Could not find package laravel/installer 或 file_put_contents failed to open stream：
- 先换国内镜像源：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 手动全局安装：composer global require laravel/installer（不加
--dev） - Windows 用户注意：
laravel.bat文件第一行依赖php.exe路径，若用 XAMPP/WAMP，请确保php在系统 PATH 中，或直接改用 composer create-project laravel/laravel your-project
项目内 artisan 命令执行失败
在项目目录下运行 php artisan key:generate 或自定义命令报错：
- 先确认
.env文件存在且格式正确，尤其是APP_KEY缺失会引发加密类报错 - 检查
storage和bootstrap/cache目录是否可写：chmod -R 775 storage bootstrap/cache（Linux/macOS）
CentOS/Nginx 环境还需chown -R nginx:nginx storage bootstrap/cache - 自定义命令不显示？确认已引入并注册到
app/Console/Kernel.php的$commands数组中 - 报
Class not found？运行 composer dump-autoload 刷新自动加载
报错信息模糊或无日志输出
执行命令只返回空白、500 或 “failed to open stream” 类错误：
- 打开
storage/logs/laravel.log，用 tail -f storage/logs/laravel.log 实时观察 - 确保
.env中APP_DEBUG=true（开发环境必须开启） - PHP 版本是否匹配？Laravel 11 要求 PHP ≥8.2，Laravel 9/10 可用
laravel/installer:^4 - 某些扩展缺失（如
mbstring、openssl）会导致 artisan 启动失败，运行 php -m 核对
