重装系统后需重新搭建laravel本地环境：①安装php≥8.1并启用8个必需扩展；②重装composer并配置国内镜像；③用composer create-project laravel/laravel:^10.0新建项目，生成app_key、配置.env；④执行php artisan serve启动验证。

重装系统后，Laravel 本地开发环境不是“恢复”，而是**重新搭建**——因为所有已安装的 PHP、Composer、扩展、项目文件、配置都已清空。但你不需要从零摸索，只需按顺序重建四层基础，就能快速回到可开发状态。

确认并安装 PHP 运行时（≥8.1）

重装系统后，PHP 一定不存在。Laravel 10+ 强制要求 PHP ≥ 8.1，且必须启用 mbstring、openssl、pdo、tokenizer、xml、ctype、json、intl 八个扩展。

• macOS：推荐用 Homebrew 安装完整版，例如 brew install php@8.2（自动带全扩展，含 intl）
• Windows：直接使用 Laragon 或 XAMPP 8.2+（避免旧版 PHP 7.x），安装后进控制面板勾选上述扩展
• Linux（如 Ubuntu）：sudo apt update && sudo apt install php8.2-cli php8.2-mbstring php8.2-xml php8.2-sqlite3 php8.2-intl php8.2-opcache

装完务必验证：php -v 看版本，php -m | grep -E "(mbstring|openssl|pdo|intl)"（macOS/Linux）或 php -m（Windows）逐项确认输出存在。

重装 Composer 并配置国内镜像

Composer 是 Laravel 的“搬运工”，重装系统后它也消失了。别跳过镜像配置，否则 create-project 极大概率卡死或报 zlib 错误。

Laravel

避免常见的Laravel错误：N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载

• 下载安装最新版 Composer（官网 或 Windows 直接运行 Composer-Setup.exe）
• 全局配置阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 为防内存不足，临时加限制：COMPOSER_MEMORY_LIMIT=-1（Linux/macOS 加入 shell 配置；Windows 在命令前加该变量）

重建项目（不依赖旧缓存）

旧项目的 .env、vendor、bootstrap/cache 全部失效，不能复用。必须重新拉取、生成、配置。

• 用指定 LTS 版本创建（避免兼容问题）：composer create-project laravel/laravel:^10.0 myapp
• 进入项目：cd myapp
• 复制环境文件：cp .env.example .env
• 生成密钥：php artisan key:generate（这步必须做，否则 500 错误）
• 改 .env 中三项关键值：
  APP_URL=http://localhost:8000
DB_DATABASE=homestead（或你新建的数据库名）
  DB_USERNAME=root（XAMPP/Laragon 默认无密码，DB_PASSWORD= 留空，不要写 null 或删掉这一行）

启动服务并验证

最后一步是确认整个链路通了：

• 执行：php artisan serve（默认监听 http://127.0.0.1:8000）
• 浏览器打开 http://localhost:8000，看到 Laravel 欢迎页即成功
• 如果报错，优先检查：
  — 是否漏了 key:generate？
  — .env 改完是否清过缓存？运行 php artisan config:clear && php artisan cache:clear
  — 数据库服务（MySQL）是否已启动？Laragon/XAMPP 控制面板里确认 MySQL 是绿色运行状态