多数情况是PHP短标签未启用——XAMPP默认关闭short_open_tag,而Typecho部分模板或插件使用短标签,导致代码不解析、输出为空白页。

为什么Typecho在XAMPP里启动后显示空白页
多数情况是PHP短标签被禁用,而Typecho模板大量使用而非<?php 。XAMPP默认关闭short_open_tag,导致解析失败,返回空响应。
打开XAMPP\php\php.ini,搜索short_open_tag,将其设为On:
short_open_tag = On改完必须重启Apache,否则无效。别只改错位置(比如改了
php.ini-development却没改实际加载的php.ini),可用phpinfo()确认当前生效配置路径。
MySQL连接失败:Typecho安装时提示“数据库连接错误”
XAMPP的MySQL默认用户名是root,密码为空,但Typecho安装界面若填了密码或主机名写成127.0.0.1,可能因权限或socket机制失败。
- 数据库主机名填
localhost(不是127.0.0.1),XAMPP下localhost走Unix socket,更可靠 - 用户名填
root,密码留空(哪怕你记得自己设过密码,XAMPP默认就是空) - 确保MySQL服务已启动——看XAMPP控制面板里MySQL状态是否为“Running”,别只点Start没等它真正就绪
修改主题后CSS/JS不更新,浏览器反复加载旧资源
Typecho本身不带资源版本控制,开发中常因浏览器缓存导致样式失效,尤其本地环境没CDN干扰,反而更难察觉是缓存问题。
临时解决办法有三个:
- 强制刷新:Windows/Linux按
Ctrl + F5,macOS按Cmd + Shift + R - 在主题文件的
<link>和<script></script>标签里手动加版本参数,比如style.css?v=1.0.1 - 开发阶段直接禁用浏览器缓存:Chrome开发者工具→Network→勾选
Disable cache(仅DevTools开启时生效)
用XAMPP跑Typecho做模板开发,哪些路径要特别注意
Typecho依赖/usr/、/admin/等固定URL路径,本地运行时如果把Typecho放在子目录(如http://localhost/myblog/),必须同步调整后台设置里的“站点地址”和“后台地址”,否则登录跳转404、静态资源404、Ajax请求跨域失败全堆一块儿。
正确做法:
- 把Typecho解压到
XAMPP\htdocs\根目录,访问http://localhost/,避免子路径陷阱 - 若必须放子目录,安装完成后进数据库改
typecho_options表里的siteUrl和adminUrl字段,值要带完整路径,比如http://localhost/myblog/,末尾斜杠不能少 - 主题里所有
__TYPECHO_THEME_DIR__生成的路径是相对当前URL的,别硬编码/themes/xxx/
本地开发容易忽略服务器重写规则差异——XAMPP默认没开mod_rewrite,但Typecho伪静态依赖它。启用方法:打开XAMPP\apache\conf\httpd.conf,取消注释LoadModule rewrite_module modules/mod_rewrite.so,再重启Apache。


















