重装系统后需重新搭建Laravel本地环境：①安装PHP≥8.1并启用8个必需扩展；②重装Composer并配置国内镜像；③用composer create-project laravel/laravel:^10.0新建项目，生成APP_KEY、配置.env；④执行php artisan serve启动验证。
确认并安装 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 错误。
- 下载安装最新版 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:8000DB_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 是绿色运行状态
