Laravel 10 在 Windows 10 XAMPP 上报错，主因是环境配置不当：需用 XAMPP 8.2+（PHP ≥8.1），启用 mbstring、openssl 等扩展，开启 Apache mod_rewrite 并设 AllowOverride All，配置虚拟主机指向 public 目录，确保 storage 和 bootstrap/cache 可写。

Windows 10 上装 Laravel 10 报错，90% 不是 Laravel 的问题，而是 XAMPP 环境没配对——尤其 PHP 版本、Apache 路由和扩展启用这三块最容易翻车。

确认 PHP 版本 ≥ 8.1 并启用必需扩展

Laravel 10 明确要求 PHP 8.1 或更高版本。XAMPP 7.4（含 PHP 7.4）已彻底不兼容，必须使用 XAMPP 8.2+（自带 PHP 8.2.x）。

• 打开 XAMPP 控制面板 → Shell → 执行 php -v，确认输出类似 PHP 8.2.12
• 执行 php -m | findstr /i "mbstring openssl pdo tokenizer xml ctype json"，缺哪个就启哪个
• 编辑 C:\xampp\php\php.ini，取消以下行前的分号：
  extension=mbstring
  extension=openssl
  extension=pdo_mysql
  extension=tokenizer
  extension=xml
  extension=ctype
  extension=json
• 改完必须重启 Apache，否则不生效

Apache 必须启用 mod_rewrite 并允许 .htaccess 覆盖

没开 mod_rewrite 或 AllowOverride All，所有路由都会 404——Laravel 的 public/.htaccess 根本不会被读取。

XAMPP 8.0.30

XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin

下载

• 打开 C:\xampp\apache\conf\httpd.conf
  确保 LoadModule rewrite_module modules/mod_rewrite.so 这行未被注释
• 找到 <Directory "C:/xampp/htdocs"> 块（或类似路径），把里面的 AllowOverride None 改成 AllowOverride All
• 确认你的 Laravel 项目根目录下存在 .htaccess 文件（Laravel 10+ 自带，别手动删）
• 保存后务必重启 Apache

用虚拟主机把域名指向 public 目录

直接访问 localhost/myapp/public 能显示欢迎页？说明 Laravel 已装好，但环境没配到位。硬编码 public 路径会导致 route()、asset() 生成错误 URL，必须通过虚拟主机映射。

• 编辑 C:\xampp\apache\conf\extra\httpd-vhosts.conf，末尾追加：

<VirtualHost *:80>
  DocumentRoot "C:/xampp/htdocs/myapp/public"
  ServerName myapp.test
  <Directory "C:/xampp/htdocs/myapp/public">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
  </Directory>
</VirtualHost>

• 同时在系统 hosts 文件（C:\Windows\System32\drivers\etc\hosts）中加一行：
  127.0.0.1 myapp.test
• 重启 Apache，然后浏览器访问 http://myapp.test

检查 storage 和 bootstrap/cache 写权限

artisan 命令报“Permission denied”或页面空白，大概率是缓存/日志目录不可写。

• 进入 Laravel 项目根目录，运行：
  chmod -R 777 storage bootstrap/cache（Windows 下可用 Git Bash 或 PowerShell 执行）
• 若无 chmod 命令，可右键文件夹 → 属性 → 安全 → 编辑 → 给当前用户赋予“完全控制”权限
• 首次运行时建议执行：
  php artisan config:clear && php artisan cache:clear && php artisan view:clear