CSS 注释
你已经会写样式规则,也会给页面引入样式表了。但有时你想在代码旁边给自己留一条备忘,或者测试时想先把某条样式“关掉”而不是删掉。这时就要用到 CSS 注释。
什么是 CSS 注释?
CSS 注释是写在 /* 和 */ 之间的一段说明文字。浏览器在应用样式时会完全忽略它。你可以用它写简短的提醒、给样式表分段加标题,或者在调试时临时停用某条规则。
注释怎么写
注释的写法是:/* 在这里写你的说明 */。从开头的 /* 到结尾的 */ 之间的所有内容,CSS 引擎都不会处理。访问者不会在页面上看到注释,它只存在于样式表源码里(打开文件时,在开发者工具 DevTools 中也能看到)。
单行注释
css/* Brand teal for the hero heading */
.hero {
color: #0f766e;
}
为什么短说明就够了
规则上方的一行注释可以交代某个值为什么这样写,比如品牌色、临时修复,或是出于无障碍考虑的选择。写得简短就好,不用长篇大论;过几周后,你只需要一个小提示就能想起来。
多行注释
注释可以跨越多行。常见的做法是在一组相关规则前放一个小小的“分区标题”,这样很长的样式表也能一眼扫完。
多行分区注释
css/*
Header styles
Keep logo and nav colors here
*/
.site-header {
background: #0f172a;
color: #f8fafc;
}
多行注释要保持简短。如果文件中间塞满大段说明,读起来反而比完全没有注释更费劲。
临时禁用一条规则
你可以把一条声明(declaration),或者整条规则,包进注释里,这样不用删除就能让它失效。之后把注释符号去掉,样式就恢复了。排查到底是哪个属性把布局搞乱时,这个办法特别好用。
注释掉一条声明
css.hero {
color: #0f766e;
/* font-size: 2rem; */
font-family: Georgia, serif;
}
测试时的好习惯
每次只注释掉对排查有帮助的最小一段,先从一条声明开始。如果页面恢复正常,说明问题就出在这里。接着要么修正这个值,要么把没用的代码删掉。不要把大段被禁用的代码永远留在已经完成的样式表里。
和 HTML 注释不是一回事
HTML 注释用 <!-- 和 -->,CSS 注释用 /* 和 */。不要把 HTML 的注释符号粘贴进 .css 文件(在 <style> 块里也不行,因为那里遵循的是 CSS 语法)。每种语言都有自己的注释写法。如果你之前学过 HTML 注释,可以把它当作一项类似的技能,只是符号不同。
注释不是保险箱
任何能打开样式表的人(或者能查看网页源代码、Network 面板的人)都能读到你的注释。千万不要在 CSS 注释里写密码、私钥或机密令牌。注释是用来写开发备忘的,不是用来藏敏感数据的。
动手试一试
- 打开一个练习用的样式表(或
<style>块),里面有一条设置了color和font-size的.hero规则。 - 在规则上方写一行注释,说明为什么选这个颜色。
- 把
font-size这条声明包进/* … */,保存并刷新页面:字号会回到默认值,而颜色仍然生效。 - 去掉
font-size周围的注释符号,再刷新一次,样式就恢复了。 - 选做:在这组规则上方加一段简短的多行分区注释。
常见错误
- 在 CSS 里使用 HTML 的符号(
<!-- -->)——CSS 引擎不会把它们当作注释 - 忘了写结尾的
*/,导致样式表后面的内容全被忽略 - 试图嵌套注释(
/* outer /* inner */ still broken */)——CSS 注释不能正确嵌套 - 在线上文件里长期留着大段被注释掉的规则
- 把机密信息或私有网址写进注释
小结
- CSS 注释写在
/*和*/之间 - 浏览器应用样式时会忽略注释内容
- 可用于简短说明、分区标题,或测试时临时禁用
- HTML 注释是
<!-- -->,不要把这种写法带进 CSS - 注释在源码中是可见的,千万别在里面存放机密
🧠 测试您的知识
测试您的知识
通过这个互动测验挑战自己,看看你对这个主题的理解程度如何
📝 说明
- 仔细阅读每个问题
- 为每个问题选择最佳答案
- 您可以随时重新参加测验
- 您的进度将显示在顶部