美文网首页生信实战日志
代码注释,利人利己

代码注释,利人利己

作者: Phoenix_Zh | 来源:发表于2020-03-10 00:12 被阅读0次

1. 什么是代码注释?

程序员在代码中加入的辅助说明信息,不能被计算机执行,也不受语法约束,可以在里面写入任何内容。

2. 为什么要注释代码?

一般来说,注释用来帮助程序员记录程序设计方法,辅助程序阅读

每当我们学习别人的代码时,常常感觉像在看文言文,心里想着找作者问问这脚本都是什么意思;也别提看别人的了,有时候看自己一个星期前写的脚本都得花费好长时间,才能弄懂其中一两行代码的目的。

所以说脚本中的注释不仅可以辅助他人阅读,更重要的是方便我们以后查看。毕竟一个逻辑清晰、代码优秀的脚本,自己看着也很有成就感。

3. 如何进行代码注释?

单行注释以#开头;多行注释以```/---开头和结尾

4. 需要注释哪些内容

对脚本的说明,比如脚本是什么时候写的、主题是什么、内容是什么、注意标明作者和邮箱(方便与他人进行交流);对代码的说明,比如包的用途、函数的用途、代码的内容...

最后来几行R语言中的代码感受一下

脚本的前几行用来注明时间主题内容作者以及邮箱

---
time: ----/--/--
title: ""
keywords: "","","","",""
author: Phoenix_Z
e-mail: zyfeng1996@163.com
---

对一些重要的、难懂的代码用#进行注释说明。

因为设置运行环境和保存历史记录,是我每次写脚本必写的几行代码,所以这里就以这几行代码为例,展示一下如何用#注释

setwd("~/filename/sub_filename")#设置运行环境
getwd()#获取当前运行环境

#保存运行环境和历史记录
save.image("~/filename/sub_filename/Environment.RData")
savehistory("~/filename/sub_filename/History.Rhistory")

#加载环境和历史记录
load("~/filename/sub_filename/Environment.RData")
load("~/filename/sub_filename/History.Rhistory")

相关文章

  • 代码注释,利人利己

    1. 什么是代码注释? 程序员在代码中加入的辅助说明信息,不能被计算机执行,也不受语法约束,可以在里面写入任何内容...

  • Python 代码注释格式

    Python代码 注释 # 注释内容 # 订单模块 HTML代码 注释

  • Android studio 上非常好用的快捷键

    注释代码(//) Ctrl + / 注释代码(/**/) Ctrl + Shift + / 格式化代码 ...

  • Android Studio Mac快捷键

    // Command + / 注释代码 注释代码(/**/) Command + Option + / 格式...

  • Xcode 插件的使用

    1.代码注释(单行注释,多行注释,方法注释,方法集注释)2.使用Xcode自定义代码块 第一个问题:代码注释插件 ...

  • Python之注释

    以#开头的行就是注释 单行注释:#注释 #只能注释掉#后的部分 代码前的注释是为了解释下面的代码;代码后的注释是为...

  • ECLIPSE快捷键和注释

    JAVA的注释有单行注释:// 一般用于单行代码注释 多行注释:/* * */ 一般用于多行代码注释 文档注释...

  • iOS 注释

    1、规范的注释让代码更好看 2、规范的注释让代码更实用 注释(单行注释) /* <##> */ 注释(预编译注释...

  • idea环境快捷键

    ActionMac OSXWin/Linux 注释代码(//)Cmd + /Ctrl + / 注释代码(/**/)...

  • Java基本语法

    注释:单行注释://[用一行注释对代码进行解释说明] 多行注释:/**/ [用多行注释对代码进行解释说明(注释一...

网友评论

    本文标题:代码注释,利人利己

    本文链接:https://www.haomeiwen.com/subject/ifwvdhtx.html