apache mod_rewrite在.htaccess中生效需三层配合：启用模块、allowoverride all授权、规则语法正确；缺一不可，否则规则完全不生效。
Apache 的 mod_rewrite 在 .htaccess 中能灵活工作，前提是底层环境已就绪——模块启用、目录允许覆盖、语法严谨。它不是“写了就生效”，而是依赖三层配合：服务层（mod_rewrite）、配置层（AllowOverride All）、规则层（.htaccess 内容）。下面按实际操作逻辑展开。
确保 mod_rewrite 模块已启用
这是所有重写的前提。未启用时，RewriteEngine On 会被直接忽略，且不报错，容易误判为规则写错。
- Linux（Debian/Ubuntu）执行：
sudo a2enmod rewrite - Linux（CentOS/RHEL）检查
/etc/httpd/conf/httpd.conf中是否已取消注释：LoadModule rewrite_module modules/mod_rewrite.so - Windows（XAMPP/WampServer）打开
httpd.conf，确认该行未被#注释 - 启用后必须重启 Apache：
sudo systemctl restart apache2（或httpd -k restart）
允许 .htaccess 覆盖重写指令
.htaccess 默认被禁用。即使规则写得完全正确，若对应目录的 AllowOverride 不是 All，Apache 就会跳过整个文件。
- 编辑虚拟主机配置（如
/etc/apache2/sites-available/000-default.conf） - 在
<directory></directory>块内添加两行：
AllowOverride All
Require all granted
- 注意：
AllowOverride None或AllowOverride FileInfo都不足以支持完整重写（比如RewriteCond和部分标志需要All） - 改完务必重启 Apache
编写可维护的 .htaccess 规则
规则不是越长越好，关键是结构清晰、意图明确、避免冲突。建议从最简模板起步，再叠加功能。
- 开头必须有：
RewriteEngine On（否则整段无效） - 常用基础模板（适用于 Laravel、ThinkPHP 等单入口框架）：
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php/$1 [L]
-
!-f和!-d是安全守门员：只把真实不存在的文件/目录请求转发给index.php，避免图片、CSS、JS 被错误拦截 -
[L]表示“最后一条”，防止后续规则干扰；搭配[QSA]可保留原始查询参数（如?id=123） - 要隐藏
.php后缀，可加：RewriteCond %{REQUEST_FILENAME} !-d<br>RewriteCond %{REQUEST_FILENAME}.php -f<br>RewriteRule ^(.*)$ $1.php [L]
调试与验证技巧
规则出错常表现为 500 错误、跳转失效或无限循环。快速定位问题比反复试错更高效。
- 先测试引擎是否工作：在
.htaccess中只留两行：RewriteEngine On和RewriteRule ^test$ /index.html [R=302,L]，访问/test看是否跳转 - 开启重写日志（仅开发环境）：在虚拟主机配置中加
RewriteLogLevel 3和RewriteLog "/var/log/apache2/rewrite.log"（Apache 2.2）；2.4+ 改用RewriteOptions Inherit+ErrorLogFormat配合LogLevel alert rewrite:trace3 - 避免常见陷阱：正则中特殊字符如
.、?、+必须转义；路径开头无斜杠（^about$对应/about，不是^/about$）；RewriteBase在子目录部署时需显式声明
