正在加载...

CSS 注释

你已经会写样式规则,也会给页面引入样式表了。但有时你想在代码旁边给自己留一条备忘,或者测试时想先把某条样式“关掉”而不是删掉。这时就要用到 CSS 注释。

什么是 CSS 注释?

CSS 注释是写在 /* 和 */ 之间的一段说明文字。浏览器在应用样式时会完全忽略它。你可以用它写简短的提醒、给样式表分段加标题,或者在调试时临时停用某条规则。

注释怎么写

注释的写法是:/* 在这里写你的说明 */。从开头的 /* 到结尾的 */ 之间的所有内容,CSS 引擎都不会处理。访问者不会在页面上看到注释,它只存在于样式表源码里(打开文件时,在开发者工具 DevTools 中也能看到)。

单行注释

css
CSS Code
/* Brand teal for the hero heading */
.hero {
color: #0f766e;
}

为什么短说明就够了

规则上方的一行注释可以交代某个值为什么这样写,比如品牌色、临时修复,或是出于无障碍考虑的选择。写得简短就好,不用长篇大论;过几周后,你只需要一个小提示就能想起来。

多行注释

注释可以跨越多行。常见的做法是在一组相关规则前放一个小小的“分区标题”,这样很长的样式表也能一眼扫完。

多行分区注释

css
CSS Code
/*
Header styles
Keep logo and nav colors here
*/
.site-header {
background: #0f172a;
color: #f8fafc;
}

多行注释要保持简短。如果文件中间塞满大段说明,读起来反而比完全没有注释更费劲。

临时禁用一条规则

你可以把一条声明(declaration),或者整条规则,包进注释里,这样不用删除就能让它失效。之后把注释符号去掉,样式就恢复了。排查到底是哪个属性把布局搞乱时,这个办法特别好用。

注释掉一条声明

css
CSS Code
.hero {
color: #0f766e;
/* font-size: 2rem; */
font-family: Georgia, serif;
}

测试时的好习惯

每次只注释掉对排查有帮助的最小一段,先从一条声明开始。如果页面恢复正常,说明问题就出在这里。接着要么修正这个值,要么把没用的代码删掉。不要把大段被禁用的代码永远留在已经完成的样式表里。

和 HTML 注释不是一回事

HTML 注释用 <!-- 和 -->,CSS 注释用 /* 和 */。不要把 HTML 的注释符号粘贴进 .css 文件(在 <style> 块里也不行,因为那里遵循的是 CSS 语法)。每种语言都有自己的注释写法。如果你之前学过 HTML 注释,可以把它当作一项类似的技能,只是符号不同。

注释不是保险箱

任何能打开样式表的人(或者能查看网页源代码、Network 面板的人)都能读到你的注释。千万不要在 CSS 注释里写密码、私钥或机密令牌。注释是用来写开发备忘的,不是用来藏敏感数据的。

动手试一试

  1. 打开一个练习用的样式表(或 <style> 块),里面有一条设置了 color 和 font-size 的 .hero 规则。
  2. 在规则上方写一行注释,说明为什么选这个颜色。
  3. 把 font-size 这条声明包进 /* … */,保存并刷新页面:字号会回到默认值,而颜色仍然生效。
  4. 去掉 font-size 周围的注释符号,再刷新一次,样式就恢复了。
  5. 选做:在这组规则上方加一段简短的多行分区注释。

常见错误

  • 在 CSS 里使用 HTML 的符号(<!-- -->)——CSS 引擎不会把它们当作注释
  • 忘了写结尾的 */,导致样式表后面的内容全被忽略
  • 试图嵌套注释(/* outer /* inner */ still broken */)——CSS 注释不能正确嵌套
  • 在线上文件里长期留着大段被注释掉的规则
  • 把机密信息或私有网址写进注释

小结

  • CSS 注释写在 /* 和 */ 之间
  • 浏览器应用样式时会忽略注释内容
  • 可用于简短说明、分区标题,或测试时临时禁用
  • HTML 注释是 <!-- -->,不要把这种写法带进 CSS
  • 注释在源码中是可见的,千万别在里面存放机密

🧠 测试您的知识

准备开始

测试您的知识

通过这个互动测验挑战自己,看看你对这个主题的理解程度如何

❓
6
问题
🎯
70%
及格要求
♾️
∞
时间
🔄
∞
尝试次数

📝 说明

  • 仔细阅读每个问题
  • 为每个问题选择最佳答案
  • 您可以随时重新参加测验
  • 您的进度将显示在顶部