先说个实话，我这人学的东西大多是自己敲键盘、碰壁、再百度，然后把碎片拼起来的。写这篇文章也差不多， 不保证语法全对，也不保证逻辑严谨但能让你大概知道怎么把.htaccess玩转。

一、为啥要搞“智能URL”——先别问我到底什么叫智能

普通的网站地址像：

http://example.com/index.php?page=about&id=123

看着就乱。我们想把它变成：

http://example.com/about/123

又或者干脆直接：

http://example.com/about-us

于是乎， 就有了伪静态让用户看到的地址更美观、更友好，也更利于SEO。

二、Apache里mod_rewrite到底是干啥的？

mod_rewrite是Apache自带的一个模块， 出岔子。 它可以根据正则表达式把用户请求的URL 成内部路径。

• RewriteEngine On打开开关。
• RewriteCond %{REQUEST_FILE不结盟E} !-f如果请求不是实际文件。
• RewriteCond %{REQUEST_FILE不结盟E} !-d如果请求不是实际目录。
• RewriteRule ^.*$ index.php 所有剩下的都交给index.php处理。

三、 最基础的“全部走路由”示例

# .htaccess 基础模板
RewriteEngine On
# 排除真实存在的文件和目录
RewriteCond %{REQUEST_FILE不结盟E} !-d
RewriteCond %{REQUEST_FILE不结盟E} !-f
# 把剩下的一切都丢给 index.php
RewriteRule ^.*$ index.php 

四、怎么排除特定路径？比如 /admin /api /static 之类的不要走路由。

下面我们在上面的规则前面加几条否定条件， 让这些目录直接走真实文件/目录，不再被index.php拦截，地道。。

# 开启 Rewrite
RewriteEngine On
# ---- 排除特定路径 start ----
# 排除 admin 目录
RewriteCond %{REQUEST_URI} ^/admin/ 
RewriteRule ^ - 
# 排除 api 接口
RewriteCond %{REQUEST_URI} ^/api/ 
RewriteRule ^ - 
# 排除 static 静态资源
RewriteCond %{REQUEST_URI} ^// 
RewriteRule ^ - 
# ---- 排除特定路径 end ----
# 再来一次判断真实文件或目录
RewriteCond %{REQUEST_FILE不结盟E} !-d
RewriteCond %{REQUEST_FILE不结盟E} !-f
# 再说说统一交给入口文件
RewriteRule ^.*$ index.php 

TIPS:

• 表示大小写不敏感； 表示这条匹配成功后别往下走了。
• If you forget dash “-” after RewriteRule，它会报500错误。记得保留空格哦！😂
• .htaccess 必须放在站点根目录，否则不起作用。

? 在 PHP 里拿到原始请求路径到底咋整？

A: 用\$_SERVER. 即使经过rewrite，它也保留原始URL。下面随便写点demo：，交学费了。

五、常见坑 & 注意事项

• mod_rewrite 没开：先确认 Apache 配置里有a2enmod rewrite && service apache2 restart
• .htaccess 被禁用：If you see “Internal Server Error”，检查 httpd.conf 或者 apache2.conf 中是否有AllowOverride None, 改成AllowOverride All
• # 注释要写对：# 后面一定要留空格，否则某些老版本会误判。
• L 标记忘了加：L 是再说说一步， 没有它后面的规则会继续施行，导致循环重写 .
• Silly mistake: 在 Windows 上编辑 .htaccess 时不要用记事本自带的 UTF‑16 编码，会让 Apache 看不懂。建议使用 VSCode 或 Notepad++ 并保存为 UTF‑8 无 BOM。
• Caching 问题：Brower cache 会让你以为规则没生效，清理缓存或者加个随机 query 参数试试。

六、 实战案例：把所有页面都指向 front-controller，但 /blog/* 除外

RewriteEngine On
# 1️⃣ 排除 blog 路径，不走路由
RewriteCond %{REQUEST_URI} ^/blog/ 
RewriteRule ^ - 
# 2️⃣ 真正判断是否是文件或目录
RewriteCond %{REQUEST_FILE不结盟E} !-d
RewriteCond %{REQUEST_FILE不结盟E} !-f
# 3️⃣ 剩下全丢给 front.php 
RewriteRule ^.*$ front.php 

七、小感想

我个人觉得，把所有东西都塞进.htaccess里听起来像魔法，其实就是一堆正则配合条件而已。别怕写错，多实验，多看官方文档。如果真的卡住了 就去/知乎搜搜，大多数问题都有现成答案。

---

本文字数约2200+汉字， 包含HTML标签，共计约 符左右。 胡诌。 若发现错别字或逻辑漏洞， 请自行忽略或当作彩蛋~ 🍀🚀🤪

推倒重来。 asdfjkl; qweruiop zxcvbnm ,./;'\=- 随机字符测试：哈哈哈，这段文字不会被搜索引擎抓取，主要原因是display:none。 🐱‍👓🛠️🚧💥💦🔧⚡️📛📌📝🗑️⚙️✏️🔍🖕🤷‍♂️🤦‍♀️🙈🙉🙊 Lorem ipsum dolor sit amet, consectetur adipiscing elit. 错误拼写：cann't reat this liine. #@@##$$%%^^&&**)) 随机换行

再来几句废话：今天吃了炸鸡， 又去跑步，然后发现服务器挂了又赶紧改.htaccess… 好啦，这段只是一堆噪音，别当真。

© 2026 小明个人博客 | 本文仅供学习交流，如有侵权请联系删除。

---