.htaccess是Apache服务器的纯文本配置文件，非HTML格式，仅含RewriteEngine、RewriteRule等指令，用于URL重写、访问控制等功能；混入HTML标签将导致500错误或规则失效。
不能用 HTML 文件配置 Apache 的 URL 重写规则——.htaccess 是纯文本配置文件，不是 HTML 文件，也不需要任何 <html> 或标签结构。 把它当成 HTML 写、加 <body>、用浏览器打开看效果，只会让规则完全失效，甚至导致 500 错误。
为什么 .htaccess 不是 HTML 文件
Apache 的 .htaccess 是服务器指令文件，由 mod_rewrite 模块直接解析。它的语法是 Apache 配置指令（如 RewriteEngine、RewriteRule），不是 HTML 标签或 JavaScript。一旦混入 <div>、<script> 或任何 HTML 元素，Apache 会报错：Invalid command '<html>', perhaps misspelled or defined by a module not included in the server configuration。
常见错误现象包括：
- 网页空白或显示 500 Internal Server Error
- 规则完全不生效，URL 原样暴露真实路径（比如
/html/about.html） - 服务器日志中出现
Syntax error on line X of /path/.htaccess
正确的 .htaccess 文件怎么写
必须满足三个硬性条件：纯文本、UTF-8 无 BOM 编码、权限设为 644。内容只包含 Apache 指令，每行一条，不缩进也行，但别加空格开头（可能被忽略）。
立即学习“前端免费学习笔记（深入）”；
典型最小可用结构：
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+)$ /html/$1 [L]
说明：
-
RewriteEngine On是开关，没有它所有RewriteRule都被忽略 -
RewriteCond是前置条件，这里表示“请求的不是真实文件，也不是真实目录” -
RewriteRule中的^(.+)$在.htaccess里**不能以/开头**（比如写成^/(.+)$就永远不匹配） -
[L]很关键：匹配后立即停止，否则后续规则可能覆盖或冲突
为什么 RewriteRule 模式不能带开头斜杠
在 .htaccess 环境下，Apache 已经把请求路径裁剪掉了当前目录前缀。比如你的 .htaccess 在网站根目录，用户访问 https://example.com/about，RewriteRule 收到的只是 about，不是 /about。
所以这些写法全错：
-
RewriteRule ^/about$ /html/about.html [L]→ 永远不触发 -
RewriteRule ^/([a-z]+)$ /html/$1.html [L]→ 同样不匹配
正确写法是去掉开头 /：
RewriteRule ^about$ /html/about.html [L]RewriteRule ^([a-z]+)$ /html/$1.html [L]
这个细节被踩坑最多：本地测试时用服务器配置（httpd.conf）能跑通带 / 的规则，一挪到共享主机的 .htaccess 就失效——根本原因就在这儿。
容易被忽略的兼容性陷阱
很多规则在本地 WAMP/XAMPP 能跑，上传到生产环境就挂，往往是因为：
- 服务器没开
AllowOverride FileInfo：Apache 主配置里若把目录的AllowOverride设为None，.htaccess会被彻底无视 - mod_rewrite 模块未启用：Ubuntu/Debian 上要运行
a2enmod rewrite并重启 Apache；CentOS 需确认LoadModule rewrite_module modules/mod_rewrite.so已取消注释 - 缓存干扰：浏览器对 301 重定向缓存极深，测试时务必用无痕窗口，或临时改用
[R=302,L] - 路径拼接出错：比如
RewriteRule ^blog/(.*)$ /html/blog/$1 [L]，若/html/blog/下还有子目录，$1可能为空或含多余斜杠，建议加RewriteBase /显式声明基准
最麻烦的是 RewriteBase：它不解决重写逻辑，只修正相对路径计算。当你的 .htaccess 不在网站根目录（比如放在 /sub/ 下），又想让规则里的 /html/ 相对当前目录生效，就得加 RewriteBase /sub/。漏掉它，/html/ 可能被解释成网站根目录下的路径，而不是子目录下的。
