XAMPP部署Typecho及伪静态设置教程

在XAMPP环境下成功部署Typecho并启用伪静态远不止后台一键勾选那么简单——必须严格完成三大关键步骤：启用Apache的mod_rewrite模块、将对应目录的AllowOverride设为All以允许.htaccess生效、并在网站根目录手动配置正确路径的.htaccess文件（尤其注意RewriteBase需与实际部署路径精准匹配）；任何一步遗漏或配置错误，都会导致非首页链接404、403甚至500报错，而Typecho后台薄弱的检测机制极易误导用户。这篇教程直击实操中最常踩坑的细节，帮你绕过“看似启用实则无效”的伪静态陷阱，真正让友好的URL结构稳定运行。

XAMPP环境下Typecho的伪静态不能只靠后台“启用地址重写”就生效，mod_rewrite 模块必须启用，且 .htaccess 文件权限要放开，否则所有非首页链接都会 404 或 403。

确认 Apache 已加载 mod_rewrite 模块

这是最常被跳过的一步。XAMPP 默认可能没启用重写模块，即使你写了 .htaccess 也完全不生效。

• 打开 XAMPP\apache\conf\httpd.conf
• 搜索 LoadModule rewrite_module，确保这行前面没有 #（即未被注释）
• 如果被注释了，删掉开头的 #，保存文件
• 重启 Apache（通过 XAMPP 控制面板）
• 可选验证：访问 http://localhost/server-info（需开启 mod_info），搜索 rewrite 看是否在已加载模块列表中

修改 httpd.conf 允许 .htaccess 覆盖规则

即使 mod_rewrite 开了，Apache 默认仍会忽略 .htaccess 里的重写指令，因为 AllowOverride 被设为 None。

• 仍在 httpd.conf 中，搜索 或类似路径段（具体取决于你的 DocumentRoot）
• 找到其中的 AllowOverride None，改为 AllowOverride All
• 同时确认该 块里有 Require all granted（旧版是 Order allow,deny + Allow from all）
• 保存并重启 Apache

Typecho 根目录必须存在正确 .htaccess 文件

很多用户以为后台开了“地址重写”就自动写规则，其实 Typecho 不会生成或写入 .htaccess，得手动放一个。

• 在 Typecho 网站根目录（即 htdocs/your-blog/）下新建或编辑 .htaccess
• 内容必须是 Apache 兼容格式，推荐用官方标准规则：

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ /index.php/$1 [L]
</IfModule>

注意：RewriteBase 值要和实际部署路径一致 —— 如果博客放在子目录如 /blog/，这里就得写 RewriteBase /blog/，否则重写会错位。

后台设置与常见报错处理

Typecho 后台“永久链接”页的检测逻辑很弱，它只检查 index.php 是否能被重写掉，不校验服务器真实配置是否生效。

• 进入后台 → 设置 → 永久链接 → 勾选「是否使用地址重写功能」
• 大概率出现红色提示「重写功能检测失败」——直接忽略，继续勾选「强制启用」并保存
• 如果保存后页面仍 404，优先检查浏览器地址栏是否还带 index.php；带说明重写根本没触发，回退查前三个步骤
• 如果出现 500 错误，大概率是 .htaccess 语法错误或 RewriteBase 路径写错
• 如果首页正常、其他页面 403，说明 AllowOverride 没改对，或目录权限没放开

真正卡住人的地方往往不是规则本身，而是 AllowOverride All 没配到 Typecho 所在的具体 块 —— XAMPP 的 httpd.conf 里可能有多个 ，只改了默认的 htdocs 主目录，却漏掉了你实际放博客的子目录路径。

今天关于《XAMPP部署Typecho及伪静态设置教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！