代码注释是什么意思? 怎么写? - 小白博客网

代码注释是什么意思? 怎么写?

作者: 管理员

全网最全的网络资源分享网站

手机扫码查看

标签:

特别声明:文章多为网络转载,资源使用一般不提供任何帮助,特殊资源除外,如有侵权请联系!

哈喽!大家好,欢迎来到小白博客网,今天简单给大家讲下代码注释怎么写。

  代码注释的目的与作用

  方便编辑、提高可读性和可维护性。

  代码注释语法和快捷键

单行注释:// 
快捷键:ctrl+/ 
多行注释:/**/ 
快捷键:ctrl+shift+/

  代码注释的规范

  1、注释符与注释内容之间加一个空格

  2、注释行与上方代码间加一个空行

 HTML代码顶部注释

 /**
  * @description: 程序说明
  * @author: name
  * @update: name(xxxx-xx-xx)
  */

HTML代码注释

<!--需要注释的部分-->

CSS代码注释

/**
 * @func
 * @todo 这个函数需要优化
 * @desc 一个带参数的函数
 * @param {string} a - 参数a
 * @param {number} b=1 - 参数b默认值为1
 * @param {string} c=1 - 参数c有两种支持的取值</br>1—表示x</br>2—表示xx
 * @param {object} d - 参数d为一个对象
 * @param {string} d.e - 参数d的e属性
 * @param {string} d.f - 参数d的f属性
 * @param {object[]} g - 参数g为一个对象数组
 * @param {string} g.h - 参数g数组中一项的h属性
 * @param {string} g.i - 参数g数组中一项的i属性
 * @param {string} [j] - 参数j是一个可选参数 
 * @returns {boolean} 返回值为true
 */
分享到:
打赏
未经允许不得转载:

作者: 管理员, 转载或复制请以 超链接形式 并注明出处 小白博客网
原文地址: 《代码注释是什么意思? 怎么写?》 发布于2021-12-28

评论

切换注册

登录

忘记密码?

您也可以使用第三方帐号快捷登录

切换登录

注册

验证码

代码注释是什么意思? 怎么写?

长按图片转发给朋友

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏