单行注释用//或#,适用于简短说明或调试;2. 多行注释用/.../,适合函数说明或大段代码禁用;3. 禁止嵌套多行注释,应根据场景合理使用以提升代码可读性。

在PHP开发中,注释是提升代码可读性和维护性的重要手段。正确使用单行和多行注释,不仅能帮助自己理清逻辑,也方便团队协作。下面直接说明它们的核心区别与使用场景。
单行注释:简洁明了,适合短说明
单行注释使用 // 或 # 符号,仅对当前行有效。
常见用法:
- // 用于调试时临时屏蔽代码
- // 解释某一行代码的作用,比如:$age = 25; // 用户年龄
- # 这种写法较少见,但功能等同于 //
注意:// 只作用于该行,换行后注释失效。
立即学习“PHP免费学习笔记(深入)”;
多行注释:大段说明,适合复杂描述
多行注释以 /* 开始,以 */ 结束,可以跨越多行。
适用情况:
- /* 在函数或类上方添加详细说明 */
- /* 注释掉一大段暂时不用的代码 */
- /* 支持换行,可写多行文档说明 */
注意:多行注释不能嵌套,即不能在 /* ... */ 中再写一对 /* ... */。
实际使用建议
日常开发中:
- 用 // 写简短备注,如变量说明或调试标记
- 用 /* */ 写函数说明、版权信息或临时移除代码块
- 避免过度注释,只在关键逻辑处添加
基本上就这些。掌握好两种注释的使用时机,代码会更清晰易懂。











