laravel new 命令能用说明 laravel/installer 已安装且 PATH 配置正确;不能用则大概率是 PATH 未包含 Composer 全局 bin 目录(如 ~/.composer/vendor/bin)或 Composer 未就绪,应先检查是否执行过 composer global require laravel/installer、PATH 是否生效及终端是否重启。

laravel new 命令能用,说明 laravel/installer 已装好;不能用,八成是 PATH 没配对或 Composer 没就绪——别急着重装,先查这三处。
laravel new 报 command not found 怎么办
这不是 Laravel 的问题,而是系统找不到 laravel 这个可执行文件。根本原因是 Composer 全局 bin 目录没进 PATH。
- 先确认是否真装了:
composer global require laravel/installer执行过没有?装完后运行composer global list,看输出里有没有laravel相关命令 - 再查 PATH:
echo $PATH(macOS/Linux)或echo %PATH%(Windows),确认里面包含 Composer 的全局 bin 路径(如~/.composer/vendor/bin或%USERPROFILE%\AppData\Roaming\Composer\vendor\bin) - 如果路径存在但 still not found,重启终端(或重新加载 shell 配置,比如
source ~/.zshrc);Windows 用户可能需要重启 PowerShell 或 CMD
laravel new 创建的项目为什么没 vendor 目录
laravel new 默认走的是「预构建骨架包」下载机制,不是跑 composer install,所以不生成 vendor/ 是正常行为——它把依赖打包进 PHAR 里了,解压即用。
- 这种模式快、离线友好,适合快速验证或网络受限环境
- 但如果你需要修改
composer.json或加新包,必须手动进项目目录执行composer install(此时会生成vendor/) - 想一步到位带
vendor/?改用composer create-project laravel/laravel myapp "11.*",它强制走完整 Composer 流程
laravel new 后 php artisan serve 启动失败常见原因
项目结构没问题,但 php artisan serve 卡住或报错,基本和本地 PHP 环境强相关,和 Installer 无关。
-
Failed to listen on 127.0.0.1:8000:端口被占,加--port=8001换个端口 -
Class 'PDO' not found:PHP 缺扩展,Ubuntu 上跑sudo apt install php-pdo,macOS 用brew install php@8.2并确认php.ini里开了extension=pdo.so - 页面空白或 500 错误:检查
storage/和bootstrap/cache/权限,运行chmod -R 775 storage bootstrap/cache - 首次访问极慢:可能是 OPCache 关闭或
.env里APP_KEY没生成,补上php artisan key:generate
laravel new 和 composer create-project 选哪个
没绝对优劣,取决于你要什么:
- 要快、要轻量、不打算立刻改依赖 → 用
laravel new,尤其适合教学演示或临时测试 - 要可控、要指定版本(比如锁定
"11.2.0")、要确保vendor/完整且可调试 → 用composer create-project laravel/laravel myapp "11.*" - 注意:
laravel new默认拉最新稳定版,不支持版本号参数;而create-project支持,且更贴近生产部署流程


















