magento 2.4.x在xampp上需满足：php 8.1–8.3（推荐xampp 8.2.12）、启用curl/gd/mbstring/openssl/pdo_mysql/soap/xml/zip/intl等扩展（intl需icu版本匹配）、memory_limit≥2g、apache设allowoverride all并启用mod_rewrite、mysql禁用strict_trans_tables、手动创建并取消var/pub/static/generated/app/etc文件夹“只读”属性，且以管理员权限运行安装命令。
Magento 2 对 XAMPP 版本和 PHP 扩展的实际兼容要求
Magento 2.4.x（当前主流稳定分支）在 XAMPP 上跑不起来，大概率不是配置错，而是 XAMPP 自带的 PHP 版本或扩展缺失。官方明确要求 PHP 8.1–8.3，而多数人用的 XAMPP 8.2.x 默认配的是 PHP 8.2.0，看似合规，但 php.ini 中关键扩展常被禁用或版本不匹配。
必须启用的扩展包括：curl、gd、mbstring、openssl、pdo_mysql、soap、xml、zip；特别注意 intl 扩展——XAMPP 8.2.x 的 php_intl.dll 依赖 icu*.dll，若 Apache 启动时报 PHP Startup: Unable to load dynamic library 'intl'，说明 ICU 版本不一致，不能简单复制 DLL。
- 推荐直接使用 XAMPP 8.2.12（含 PHP 8.2.12），其
intl和 ICU 兼容性已验证 - 检查方式：运行
php -m | findstr intl（Windows 命令行），有输出才算真正加载成功 -
memory_limit至少设为2G，Magento 2 安装器和编译阶段极易因内存不足中断
Apache 配置需绕过 XAMPP 默认的 AllowOverride None
XAMPP 的 httpd.conf 默认把所有目录设为 AllowOverride None，导致 Magento 2 的 .htaccess 文件完全失效——结果就是前台白屏、后台路由 404、静态资源 403，且错误日志里几乎不报 Apache 层问题。
必须定位到虚拟主机或主目录段落，把 AllowOverride None 改成 AllowOverride All，并确认 mod_rewrite 已启用（XAMPP 控制面板里勾选即可）。
- 修改位置通常在
C:\xampp\apache\conf\extra\httpd-vhosts.conf或httpd.conf的<directory></directory>段内 - 改完重启 Apache，用
httpd -t验证语法正确性，避免配置错误导致服务无法启动 - 如果用子目录部署（如
http://localhost/magento2），还需在app/etc/env.php中显式设置'base_url' => 'http://localhost/magento2/'，否则前端 CSS/JS 路径全错
MySQL 设置必须关闭 STRICT_TRANS_TABLES 模式
Magento 2 安装过程中会执行大量 DDL 语句，XAMPP 自带 MySQL 8.0+ 默认开启严格模式（STRICT_TRANS_TABLES），会导致建表失败，报错类似：SQLSTATE[42000]: Syntax error or access violation: 1067 Invalid default value for 'created_at'。
这不是 Magento 的 bug，是 MySQL 严格模式拒绝接受某些隐式默认值（如 DATETIME 字段设 DEFAULT NULL 但未显式声明 NULL 属性）。
- 编辑
C:\xampp\mysql\bin\my.ini，在[mysqld]下添加一行：sql_mode = "ONLY_FULL_GROUP_BY,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION" - 务必删掉原配置中的
STRICT_TRANS_TABLES和STRICT_ALL_TABLES - 重启 MySQL 服务后，执行
SELECT @@sql_mode;确认结果中不含 strict 相关关键词
安装命令执行前必须手动预置 var/ 和 pub/static/ 权限
XAMPP 运行在 Windows 上，没有 Linux 的 chmod 概念，但 Magento 2 的命令行安装器（bin/magento setup:install）仍会尝试写入 var/、pub/static/、generated/ 等目录。若这些文件夹不存在或权限受限（比如被系统标记为“只读”），安装会卡在“Writing deployment config…”或直接抛出 Permission denied 异常。
Windows 下的“权限”实际取决于文件夹属性和当前运行 CMD 的用户权限，而非 Unix 权限位。
- 手动创建空文件夹：
var、pub/static、generated、app/etc - 右键每个文件夹 → “属性” → 取消勾选“只读”，点击“应用”→“确定”
- 以管理员身份运行 CMD，再执行
php bin/magento setup:install ...，否则即使文件夹可写，Apache 用户（非当前登录用户）也可能无权操作 - 首次安装完成后，立即运行
php bin/magento setup:static-content:deploy -f，否则前端样式和 JS 仍不生效
最易忽略的是 MySQL 严格模式和 Apache 的 AllowOverride，这两个点不处理，其他配置全对也白搭。Windows + XAMPP + Magento 2 不是“能跑就行”的组合，而是每个环节都得按它的脾气来。
