☰
代码注释:让代码清晰易懂的秘诀
2026/10/26 1:55:57 网站建设 项目流程

这个知识点能解决什么问题

你写的代码, 用不了几天的功夫, 你自己连自己也搞不明白了是吧?

对于那个由其他人编制的程序代码, 你对其中的具体操作是完全不了解的。

在运行代码的过程当中, 有的人想要暂时把某一行的代码给关掉, 但是又不想去把它删除掉, 这种情况下应该怎么做呢?

注释这个东西, 就是专门用来对付这些个问题的。

给代码加上注释, 这就等同于是在为程序写一份说明书, 这样一来代码就会变得更加清晰, 也更容易进行修改, 用起来也更加顺手和方便。

知识点讲解(超通俗,零基础秒懂)

那些注释啊, 其实就是给咱们普通人看着用的, 能够让人看明白的说明性文字。

那段东西是不会被执行运行的, 它被放置在那里纯粹是用来解释说明代码的内容的。

这里有两种不同的办法来做。

所谓的单行注释, 其具体的表现形式是, 让一个 # 号位于这行文字的开头位置;而关于那个多行注释, 它的正确处理方式是要使用三个双引号""" 来将其进行包裹处理。

这句话的意思就是, 凡是前面带有#这个符号的地方, 它们都算是注释内容, 是不进行执行的。

这就是完整的代码, 你把它复制下来之后, 是能够直接运行的。

# 这是单行注释(解释下面这行代码)

# 定义图片名称变量

img_name = "证件照.jpg"

# 这也是注释

print(img_name) # 打印图片名称(行尾注释)

"""

这是多行注释

可以写很长的说明

比如:这段代码用来处理图片

"""

# print("我被注释了,不会运行")

开头是单行注释, 它不被运行, 只是用来解释后面那行的意思。接着是对变量的作用进行定义, 也就是定义变量。随后才是真正会运行的代码。如果在代码的末尾加上小星星标记的单行注释, 那么这行代码就会执行, 并且注释用来说明发生了什么。使用三个引号来表示多行注释的开始部分。

在中间插入你想要记录的多行注释内容。再次重复这些多的行的注释内容作为补充。最后用结束标志来收尾, 这样就完成了整个大段的文字性描述。如果想把某些代码片段暂时关闭起来不让它动, 就可以用这个方法。接下来看到的是程序跑完之后的实际效果显示。

在运行代码的时候, 系统只能够把确实存在的那部分内容给输出出来。

证件照.jpg

对于任何包含有#号以及在三个引号之间的内容这样的全部情况来说, 它们是完全不会被执行的, 并且也不会产生报错。

注释有 个核心作用解释代码, 意思就是我和别人一起写, 都能够看得懂。还有一种情况是临时禁用代码, 也就是说不想要直接删除掉又不希望它在运行的时候被调用, 这种做法叫做做笔记, 主要用来写功能方面的说明以及注意那些事项。

注释有两种写法第一种是单行注释, 在代码前面加上号这也就是我们说的单行注释它是大家使用得比较常用的方式;第二种是多行注释它的书写方法是用三个双引号开头再用三个双引号结尾中间就可以写入很详细的长句子这些长句子往往是一些非常复杂的描述信息。

所谓注释这东西, 它其实就是那种特别基础, 并且在实际应用中又显得特别实用的一种小技能。

只要学会了给代码写下注释, 那么代码就不会变得乱七八糟了, 在办公自动化方面编写程序的时候也会变得越来越顺手和流畅。

请关注一下博主, 这边会持续不断地更新这一系列的教程内容, 帮助大家从学习基础代码入手, 一直到最终完成软件的制作, 通过一步一个脚印的努力过程, 逐步进化成为编程方面的小能手。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询