静态资源重写是内部映射而非跳转，旨在规范路径、提升安全并隐藏真实结构；需启用mod_rewrite、allowoverride all，并在.htaccess中用^static/等相对路径匹配，配合l标志精准映射，避免[r]和多余斜杠，确保地址栏不变且响应为200。
静态资源重写不是为了改变文件位置，而是让请求路径更规范、更安全，同时避免暴露真实后缀或目录结构。核心思路是：用简洁路径指向实际存在的资源文件，不触发跳转，保持地址栏不变。
确保基础环境就绪
规则生效前必须满足三点：
- 启用 mod_rewrite 模块：在 httpd.conf 中取消注释
LoadModule rewrite_module modules/mod_rewrite.so - 允许 .htaccess 覆盖：对应站点的
<directory></directory>块中设为AllowOverride All - 根目录下存在 .htaccess，且首行必须是
RewriteEngine On
常见静态资源重写场景与写法
重点在于匹配路径、映射到真实文件，并控制行为标志：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
-
统一资源入口（如 /static/js/app → /assets/js/app.min.js）：
RewriteRule ^static/js/([a-z0-9.-]+)\.js$ /assets/js/$1.min.js [L,NC]
注意：模式不加开头斜杠（^static/...，不是^/static/...），因为 .htaccess 的上下文已剥离了目录前缀 -
隐藏真实后缀（如 /logo → /images/logo.png）：
RewriteCond %{REQUEST_FILENAME} !-fRewriteCond %{REQUEST_FILENAME} !-dRewriteRule ^logo$ /images/logo.png [L]
两个 RewriteCond 确保只对不存在的真实路径才重写，避免覆盖真实文件 -
强制 CDN 回源（如 /cdn/xxx.jpg → /public/images/xxx.jpg）：
RewriteRule ^cdn/(.+)\.(jpg|png|gif|webp)$ /public/images/$1.$2 [L,NC]
使用(jpg|png|...)限定类型，防止误匹配；[NC]忽略大小写更稳妥
关键标志与避坑要点
静态资源重写最怕无限循环或 404，标志组合要精准：
-
[L]必须加——表示终止当前轮次匹配，防止后续规则干扰 -
[NC]推荐加——资源名常不区分大小写，避免因 case 导致 404 -
[QSA]一般不用——静态资源通常无查询参数，加了反而可能带错参数过去 - 不要用
[R]——那是重定向，会改地址栏，违背“静态资源重写”的内部映射本意 - 避免路径开头多写斜杠——
^/static/...在 .htaccess 中会匹配失败，应写^static/...
验证是否真正生效
别只看浏览器能否打开，要确认是内部重写而非跳转：
- 访问
https://yoursite.com/static/css/main，页面正常加载且地址栏仍是该路径 → 成功 - 用
curl -I查响应头：状态码是 200，且没有Location:字段 → 是内部重写 - 检查 Apache 错误日志（
logs/error_log），排除bad flag delimiters或正则语法错误
