rewriteUrls选项仅重写输出CSS中的url()函数路径，不影响@import语句路径；它只做字符串替换，不校验文件存在性，且对变量拼接路径和@import (css)引入的路径完全无效。
Less的rewriteUrls选项只改输出CSS里的url()，不改@import路径
Less编译器本身不加载文件、不校验路径是否存在，rewriteUrls只是字符串重写规则——它只作用于最终CSS中显式出现的url()函数内容，对@import语句里的路径完全无感。比如你在fonts.less里写src: url("myfont.woff2")，开启rewriteUrls: 'all'后，它可能变成url("./global/myfont.woff2")；但同一文件里的@import "reset.css"仍原样输出，不会加前缀。
常见错误现象：rewriteUrls: 'all'开了，图片能加载，但@import进来的第三方CSS却404——因为那条@import url(...)没被重写，浏览器按CSS文件位置去算路径，而构建工具又没配importLoaders去接管它。
-
rewriteUrls: 'off'（默认）：所有url()保持原样，最安全但需手动对齐路径 -
rewriteUrls: 'local'：只重写以.开头的相对路径，比如url("./img/logo.png")会被调整，url("img/logo.png")不动 -
rewriteUrls: 'all'：强制给所有url()加相对于主.less文件的前缀，容易和构建工具路径映射冲突
Webpack/Vite里url()能被重写，但变量拼接的路径不能自动识别
构建工具如Webpack的css-loader会扫描CSS中的硬编码字符串（如url('../assets/logo.png')），并根据public或src/assets目录规则重写或内联；但它**不解析Less变量**。你写background: url('@{img-path}logo.png')，Less编译后变成url('../static/img/logo.png')，这时css-loader才真正看到这个字符串并处理——前提是@{img-path}拼出来的结果是它能识别的相对路径格式。
容易踩的坑：
立即学习“前端免费学习笔记（深入）”；
- 用双引号包裹：
url("@{img-path}logo.png")在某些Less版本里会转义成url("../static/img/logo.png")，浏览器无法解析 - @img-path末尾漏掉
/，拼出来变成../static/imglogo.png，直接404 - 定义
@img-path: '@/assets/img/';——Less不认识@/别名，Webpack也不处理变量里的别名，必须写死相对路径或绝对路径
@import (css)跳过Less解析，等于把路径控制权完全交给浏览器
@import (css) "normalize.css"这行代码，Less只做一件事：原样输出@import url("normalize.css")到CSS里。后续路径解析完全由浏览器执行，基准是最终CSS文件所在位置，不是.less文件位置。如果CSS输出到dist/css/app.css，而normalize.css实际在dist/static/css/，那浏览器就会请求dist/css/normalize.css，必然404。
解决方式不是靠rewriteUrls，而是构建工具配置：
- Webpack中必须写
@import (css) "~@/styles/normalize.css"，且less-loader要配paths或css-loader要认alias - Vite下
@import (css)引用public/下的文件，必须用绝对路径@import (css) "/normalize.css"，否则找不到 - 别指望
@import (css)进来的CSS内部再嵌套@import url()——那些语句浏览器运行时才加载，不受任何构建工具控制，CSP或跨域常导致静默失败
真正决定资源能否加载的，是「最终CSS里出现的字符串」+「服务器实际部署结构」
Less编译、构建工具重写、HTTP服务器响应，这三步链条里只要有一环路径不匹配，就404。关键点在于：Less变量和rewriteUrls都只是生成字符串的手段，它们不保证字符串合法，也不感知部署结构。
调试建议：
- 打开编译后的CSS文件，直接看
url(...)和@import url(...)里写的到底是什么路径 - 对比浏览器开发者工具Network面板里实际请求的URL，和服务器上文件真实路径
- 如果用了
public/目录，所有路径必须以/开头；如果用了src/assets/，路径必须和.less文件的嵌套层级对齐
最容易被忽略的是：Less里看似“统一管理”的变量，一旦拼错斜杠、混用别名、或和构建工具的路径映射逻辑脱节，就会在编译产物里埋下404隐患，而这种问题往往到上线才发现。
