Less转CSS必须在构建阶段完成，不可在容器运行时执行；因生产镜像不应包含lessc、node_modules等构建依赖，否则导致臃肿、启动慢、安全风险高，且Nginx仅需托管静态文件，无需Node.js运行时。
Less转CSS的构建任务不能在容器运行时动态执行，必须在构建阶段完成——因为生产镜像里不该装lessc、node_modules或构建工具链，否则镜像臃肿、启动慢、有安全风险。
为什么不能在容器里运行 lessc？
前端静态资源构建属于编译期行为，不是运行时需求。Nginx 容器只负责托管已构建好的 HTML/CSS/JS，它不需要 Node.js 运行时，也不该暴露构建能力。
- 装
lessc意味着要基于node镜像而非nginx:alpine，镜像体积从 ~5MB 涨到 ~1GB+ - 构建过程依赖
package.json和node_modules，这些在生产环境毫无用处，反而增加攻击面 - 每次容器重启都重新跑
lessc，既无必要又不可控（比如文件权限、路径、并发冲突）
正确做法：多阶段构建中完成 Less 编译
把 Less 构建塞进 builder 阶段，在最终镜像里只保留纯静态文件。
- 在
package.json中定义脚本："build:less": "lessc src/styles/main.less dist/css/main.css" - 确保
dist/css/路径存在，且构建后 CSS 文件真实生成（可加ls -l dist/css/验证） - Dockerfile 中让
builder阶段安装less并执行构建：RUN npm install less -g && npm run build:less - 最后阶段用
COPY --from=builder /app/dist /usr/share/nginx/html拷过去，不带源码、不带 node_modules
lessc 常见路径与权限问题
构建失败常因路径错位或权限不足，不是语法问题。
立即学习“前端免费学习笔记（深入）”；
- Less 文件路径必须相对于
WORKDIR，比如WORKDIR /app，那src/styles/main.less就得真实存在于项目根目录下 - 别用绝对路径如
/src/styles/main.less，Docker 构建上下文外的路径无效 - 如果报
Permission denied，检查是否用了ADD（会改权限）而不是COPY；或显式加RUN chmod +r src/styles/*.less - 输出路径不能是
./main.css这种相对路径，lessc在容器内执行时当前路径不固定，务必写成dist/css/main.css这类明确路径
要不要用 Webpack/Vite 管理 Less？
如果你项目已有 Webpack 或 Vite，就别单独调 lessc —— 交给它们的 loader 处理更稳妥，还能自动处理 @import、source map、压缩等。
- Webpack：配
less-loader+css-loader，构建时自动合并、提取 CSS - Vite：默认支持
.less，无需额外配置，build时直接打进assets/目录 - 关键点：无论哪种方式，产出的 CSS 必须和后续 Nginx 的
publicPath对齐，否则url(../fonts/icon.woff)仍会 404（这点比 Less 编译本身还容易漏）
真正卡住人的从来不是 lessc 命令会不会用，而是构建产物路径没对齐 Nginx 的 root 和前端的资源引用路径——三者差一层，所有字体、图片、背景图全挂。
