正在加载...
JavaScript 注释
你已经会写语句，并用正确的语法写值。本课加上引擎会跳过的东西：注释——写给自己和其他读代码的人的说明。
什么是 JavaScript 注释，如何书写？
注释是 JavaScript 引擎会忽略的文字。它不会改变程序做什么。用 // 写到该行末尾的说明，或用 /* … */ 写可跨一行或多行的说明。注释解释为什么、留下提醒，或在测试时暂时关掉一行。
注释形式一览
📊 初学者应如何使用注释
| 形式 | 示例 | 何时使用 |
|---|---|---|
单行 // |
// 显示欢迎消息 |
行上方或行末的短说明 |
多行 /* */ |
/* 多行说明 */ |
较长解释，或一次多行 |
| 代码后 | console.log(x); // 临时检查 |
语句旁的小提醒 |
| 禁用一行 | // console.log(x); |
暂时停用语句而不删除 |
| 不是给引擎的 | （任何注释） | 访客不会「运行」你的注释——只有人会读 |
用 // 写单行注释
从 // 到该行末尾都是注释。同一行上 // 前面的代码仍会执行。
console.log("Hello"); // 给控制台的问候
console.log(42); // 一个数字字面量
也可以把 // 单独放在一行，写在它所说明的语句上方。
// 输出一条简短状态消息
console.log("Ready");
用 / / 写多行注释
以 /* 开始，以 */ 结束。两者之间的内容都会被忽略——即使跨多行。
/*
演示：向访客问候一次。
对初学者保持简短。
*/
console.log("Welcome");
暂时关掉代码
把一行注释掉是常见的调试习惯：代码仍留在文件里，但在去掉注释之前不会运行。
console.log("This runs");
// console.log("This stays quiet");
console.log("This also runs");
只有中间那一行是安静的。想再要那条日志时，去掉 // 即可。
页面更新旁的注释
当语句更新页面时，一句简短的为什么注释能帮到未来的你。注释本身不会出现在页面上。
<!DOCTYPE html>
<html>
<head>
<title>Comments — Page note</title>
</head>
<body>
<h1 id="msg">Waiting…</h1>
<script>
// 脚本运行后显示清晰状态
document.getElementById("msg").textContent = "Comments help humans";
</script>
</body>
</html>
标题文字来自字符串字面量。// 那一行只给读源码的人看。
自己动手试
- 在
console.log上方加一条//说明，并在同一行末再加一条；运行并确认日志仍出现。 - 在日志上方用
/* */包住两行说明；改注释文字——输出应保持不变。 - 用
//注释掉三条console.log中的一条，运行，再恢复。 - 打开 HTML 演示；只改注释措辞；刷新并确认标题文字未变。
- 写一条说明为什么的注释（例如「临时检查」），而不是逐字重复代码。
常见错误
- 写了
/*却忘记关闭*/——后面的代码可能被吞进注释 - 以为
//会延续到下一行（它在行末结束） - 随意嵌套
/* … /* … */ … */——多行注释不能安全嵌套 - 只是复述代码的注释，而不是有用的「为什么」
- 与语法课（字面量与名称）混淆，或以为已经讲变量——注释是说明，不是存储
小结
- 注释给人看；引擎会忽略
//覆盖一行的剩余部分/* */可覆盖一行或多行- 用于为什么、提醒和暂时禁用——不要堆无意义的噪音
- 下一课：变量——保存可复用值的名字
🧠 测试您的知识
准备开始
测试您的知识
通过这个互动测验挑战自己，看看你对这个主题的理解程度如何
6
问题
70%
及格要求
∞
时间
∞
尝试次数
📝 说明
- 仔细阅读每个问题
- 为每个问题选择最佳答案
- 您可以随时重新参加测验
- 您的进度将显示在顶部