opencart 在 xampp 上无法运行主要因 php 扩展未启用、apache 权限/重写配置错误、mysql 认证方式不兼容及 v4 版本 public 目录结构适配问题；需启用 pdo_mysql、mbstring 等扩展，设置 allowoverride all，改 root 认证方式，并确保 documentroot 指向 public 目录。
OpenCart 在 XAMPP 上跑不起来，大概率不是程序问题，而是环境配置没对上——尤其是 PHP 版本、扩展和权限这三块。直接装最新版 OpenCart（v4.x）在默认 XAMPP（如 v8.2）上会报 Class "PDO" not found 或白屏，因为新版默认要求 pdo_mysql 和 mbstring 必须启用，而 XAMPP 的 php.ini 里这些是注释掉的。
确认 XAMPP 自带的 PHP 版本是否兼容目标 OpenCart 版本
OpenCart v3.0.3.7 及以下可跑在 PHP 7.4；v4.0.1.x 起强制要求 PHP 8.1+。但注意：XAMPP for Windows 最新版（如 8.2.12）自带 PHP 8.2，表面兼容，实际仍可能因扩展缺失失败。
-
XAMPP控制面板点 Admin 进phpinfo()，搜索Loaded Configuration File确认正在用的php.ini路径（通常是C:\xampp\php\php.ini） - 打开该
php.ini，取消以下行前的分号：;extension=openssl→extension=openssl；同理处理pdo_mysql、mbstring、curl、json - 改完必须重启
Apache服务，否则phpinfo()里看不到扩展状态变绿
解压后访问 install/ 目录时提示 403 或空白页
这不是 OpenCart 的错，是 Apache 没给目录执行权限或 .htaccess 生效失败。
- 确保
OpenCart文件放在C:\xampp\htdocs\opencart\（不要嵌套太深，路径含中文或空格必挂） - 检查
C:\xampp\apache\conf\httpd.conf中是否启用重写模块：LoadModule rewrite_module modules/mod_rewrite.so前不能有# - 找到
<directory></directory>区块，把里面的AllowOverride None改成AllowOverride All，否则.htaccess里的规则（比如 SEO URL 重写）直接被忽略 - 如果仍 403，临时把
C:\xampp\htdocs\opencart\install\下的.htaccess重命名为.htaccess.bak测试是否能进安装页
安装过程中卡在“Database Connection”页面，测试连接始终失败
常见原因是 MySQL 用户权限或 socket 路径不对，而不是账号密码输错了。
- 默认
root用户无密码，但新版 XAMPP（8.0+）MySQL 默认启用了auth_socket插件，导致root@localhost无法用密码登录 —— 解决方法：用phpMyAdmin登录后执行ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY ''; - OpenCart 安装页填数据库主机别写
127.0.0.1，写localhost；端口留空（XAMPP MySQL 默认 3306，但用localhost会走 socket，更稳） - 数据库名建议全小写、不含下划线（如
ocstore），避免某些 Windows 下大小写敏感的驱动异常 - 如果提示
Access denied for user 'root'@'::1'，说明 PHP 尝试用 IPv6 连接，回到上一步改用localhost即可
安装成功后前台/后台 CSS/JS 全部 404，或跳转链接变成 http://localhost/opencart/index.php?route=common/home
这是 SEO 设置和 Apache 重写没协同好，本质是 .htaccess 没生效或路径重写规则不匹配。
- 确认
config.php和admin/config.php里HTTP_SERVER和HTTPS_SERVER的值是http://localhost/opencart/（结尾带斜杠），不是http://localhost/opencart或http://localhost/ - 进入后台 → System → Settings → Edit → Server 标签页，勾选
Use SEO URLs，再保存 - 此时前台仍可能 404 JS/CSS，是因为
public/.htaccess（OpenCart v4）或根目录.htaccess（v3）未被 Apache 加载 —— 回头再检查一遍httpd.conf里的AllowOverride All是否已生效 - 如果用了 OpenCart v4，还要确认
public/是 Web 根目录（即 Apache DocumentRoot 应指向C:\xampp\htdocs\opencart\public），否则静态资源路径天然错位
php.ini 或 httpd.conf 后没重启服务」，以及「v4 的 public/ 目录结构和传统部署方式完全不同」——这两点不处理，后面所有操作都是在调一个注定失败的环境。
