写代码时加注释是为了提高代码可读性，方便自己和他人理解。应在关键地方添加注释，单行注释（//）适合解释单行代码或变量作用，如说明逻辑目的、调试屏蔽代码；多行注释（/ /）适合完整说明函数用途、参数含义及注意事项，并可用于临时屏蔽代码段；注释应清晰实用，避免重复代码内容、不相关背景或过时信息，应说明“为什么”而非仅“做了什么”，并标明公共函数的输入输出及副作用；选择单行或多行注释取决于内容长度与上下文需求，html/css中只能使用多行注释；团队开发中应遵循统一规范，保持风格一致。
写代码时加注释，是让自己和别人以后更容易看懂这段代码在干什么。很多人一开始写代码都不太注意注释，结果回过头来看自己写的代码都得想半天。其实只要在关键地方加上几句说明，就能省掉很多理解成本。
什么时候该用单行注释（//）
单行注释适合写在某一行代码的上方或后面，用来解释这行代码做了什么。它的优点是简洁，不会显得累赘。
比如：
在线订餐系统源码,提供给设计人员参考一个小型的在线订餐管理系统源码，采用三层模式开发，代码注释详细前台可以进行用户注册、菜单管理及订餐后台管理员可以进行菜单管理、新闻管理、菜肴管理、用户管理操作数据库采用的是Sql2005（由于数据库在App_Data下，如果装了Sql2005数据库会自动配置）
// 计算总价并保留两位小数 const totalPrice = (price * quantity).toFixed(2);
或者像这样写在代码后面：
let count = 0; // 初始化计数器
适用场景：
- 解释某个变量的作用
- 说明某段逻辑的目的
- 暂时屏蔽某行代码（调试时常用）
这种写法特别适合在函数内部、逻辑分支里做简单说明，不需要大段文字也能让人一目了然。
多行注释（/ /）更适合哪些情况
多行注释适合写一段比较完整的说明，比如函数用途、参数含义、注意事项等。它不会打断代码结构，适合写稍长一点的解释。
比如：
/*
* 获取用户信息
* 参数：
* userId: 用户唯一标识符
* 返回值：
* 包含用户名和邮箱的对象
*/
function getUserInfo(userId) {
// ...
}也可以临时把一段代码“注释掉”来测试效果：
/*
console.log('调试信息');
fetchData();
*/不过要注意的是，在有些语言中（比如HTML、CSS），只能使用多行注释，不能用//。
注释也要讲究清晰和实用
写注释不是为了凑字数，而是要写出真正有用的信息。比如下面这些做法就不太合适：
- 注释内容和代码重复：“设置标题”写在
title = '首页'旁边 - 写一堆不相关的背景故事
- 忘记更新注释，导致注释和实际代码不符
好注释的标准：
- 简洁明确，不说废话
- 解释“为什么”，而不是“做了什么”
- 如果是公共函数，说明输入输出和副作用
比如这样写更好：
// 需要先转成整数，防止字符串拼接出错 const num = parseInt(inputValue, 10);
单行还是多行？看场景选就好
没有绝对正确的选择，主要看你要表达的内容长度和上下文是否需要。一般来说：
- 想说一句两句，用
// - 要写个说明文档式的注释，用
/* */ - 在不同语言中也略有差异，比如HTML/CSS只能用多行注释
另外，团队有统一规范的话，按规范来就行。如果没有，保持一致风格也很重要。
基本上就这些。写注释不是难事，但确实容易被忽略。花点时间写清楚，回头省不少麻烦。
