直接运行composer install即可,前提是项目根目录存在composer.json和composer.lock文件;前者定义依赖名称与版本范围,后者记录所有依赖的确切版本与哈希值,确保vendor目录精准还原。

直接运行 composer install 即可,前提是项目里有 composer.json 和 composer.lock 文件。
确认必要文件是否存在
打开项目根目录,检查是否包含以下两个关键文件:
-
composer.json:定义了项目所需依赖的名称和版本范围 -
composer.lock:记录了上一次安装时所有依赖的确切版本和哈希值(强烈建议提交到 Git)
如果这两个文件都存在,composer install 就能精准还原和原环境一致的 vendor 目录。
执行依赖安装命令
在终端中进入项目根目录后,依次执行:
-
composer install—— 推荐首选。它会严格按composer.lock安装,确保一致性 - 如需更新到最新兼容版本,可运行
composer update(不推荐在生产或协作环境中随意使用)
注意:不要用 composer require xxx 逐个安装,除非你明确知道要加什么包。
常见报错与应对
如果运行 composer install 失败,优先检查:
- PHP 版本是否符合 Laravel 要求(当前稳定版 Laravel 11 需 PHP ≥ 8.2)
- 是否启用了必需扩展,如
openssl、mbstring、pdo、tokenizer - 权限问题:Windows 下可能需以管理员身份运行终端;Linux/macOS 下注意当前用户对
vendor/和storage/目录是否有写权限
别忘了后续必要步骤
依赖装完只是第一步,还需补全运行环境:
- 复制
.env.example为.env,并填写数据库、缓存、密钥等配置 - 运行
php artisan key:generate生成应用密钥 - 清空配置缓存:
php artisan config:clear(尤其在修改 .env 后) - 如有数据库迁移,再执行
php artisan migrate


















