是正常行为，//单行注释仅存在于less源码中，编译时被完全剥离，不输出到css；/ /块注释默认保留但可能被压缩工具删除，需配置preservecomments确保关键注释留存。
Less里写//注释，编译后CSS里根本看不到？
这是正常行为，不是bug。//是Less源码级单行注释，编译时被完全剥离，不进最终CSS。很多人误以为它能“安全留痕”，结果上线后调试找不到上下文。
常见错误现象：
- 在
.btn { // 主色按钮 } .btn-primary { ... }里加//，期望CSS里出现说明，实际啥都没留下 - 用
//临时禁用某行样式，却忘了它只在Less里生效，编译后该样式仍存在
实操建议：
- 仅把
//用于开发过程中的临时标记、逻辑开关或调试占位 - 绝不依赖
//做业务说明、兼容性提示或模块分隔——它对CSS输出零贡献 - 若需保留注释到CSS，必须改用
/* */块注释
为什么/* */块注释有时也消失了？
因为构建流程里的CSS压缩器（如css-minimizer-webpack-plugin）默认会删掉所有/* */注释。你以为写了就稳了，其实它可能在打包阶段被静默干掉。
关键影响点：
- Webpack/Vite项目开启
minimize: true时，/* v1.2.0 */这类版本注释大概率被删 - PostCSS插件如
autoprefixer本身不删注释，但后续的cssnano会 - 某些旧版
lessc（v3.x）若发现@version变量没被任何属性引用，连带其所在的/* @{version} */也会优化掉
实操建议：
- 在
css-minimizer-webpack-plugin配置中显式开启preserveComments，例如：preserveComments: /v\d+\.\d+\.\d+|Copyright/ - 避免把版本号写成孤立变量；改成直接拼进注释：
/* v@{version} — @import "version.less"; */ - 上线前用
curl your-site.com/style.css手动确认注释是否真在产物里
如何让/* */注释自动带文件名和行号？
Less本身不支持__LINE__或__FILE__这类宏，但可以用变量模拟，前提是团队统一约定格式，否则搜索定位失效。
典型写法（每个.less文件顶部）：
@comment-prefix: "/* [src/components/Button.less] ";
.btn-base() {
@{comment-prefix} 基础按钮重置 */
display: inline-flex;
}
注意陷阱：
- 别用
~"string"拼接——新版Less已弃用，且无法参与变量计算 -
@comment-prefix必须在每个文件里重新定义，不能靠@import一次注入全局（路径会错乱） - 如果注释出现在嵌套5层以上的mixin里，可能干扰sourcemap映射，Chrome开发者工具点不到原始行
Stylelint报//注释语法错误怎么办？
Stylelint默认按标准CSS语法校验，而//不是合法CSS语法，所以会报错。这不是Less的问题，是linter配置没对齐。
解决路径很窄，只有两条：
- 装
stylelint-less插件，并在.stylelintrc.js里启用：plugins: ["stylelint-less"] - 确保
extends里没有覆盖掉插件能力，比如stylelint-config-prettier本身不处理Less语法
更省事的做法：直接禁用该规则，但仅限.less文件：
rules: {
"no-invalid-double-slash-comments": null,
}
复杂点在于，一旦用了/* */又开了压缩，就得在构建链路每一环都确认注释策略是否一致——从Less编译、PostCSS处理到最终CDN缓存，漏一环就白忙。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
