Python代码注释-猿说编程

ChatGPT 3.5 国内中文镜像站免费使用啦

零基础 Python 学习路线推荐 : Python 学习目录 >> Python 基础入门

在 Python hello world开始中我们已经完成了第一个 Python 程序，代码是有了，关键是好像好不知道写的啥玩意？

一.什么是代码注释

代码注释就是给一段代码加上说明，表明这段代码的作用或者实现的功能，方便别人阅读代码。

看看上面这个图，问题来了，那个女孩是谁？张三？李四？王五？除了上帝谁也不知道（上帝：我也不知道）！！

加上注释再来一遍：禽兽，放开小红，我小明愿意和她交换。大家就都明白了，原来这个女孩叫小红，这个 Gay 叫小明。

二.为什么写代码要注释

IT圈有一个梗：当我写这段代码的时候,只有上帝和我知道,现在,只有上帝知道。上帝说：这个锅我不背！

IT圈有一句话：提交代码不写注释的人，小JJ就跟注释一样长。一个团队开发时候可能是多个人同时接管一个项目，注释都没有，谁知道你写的什么玩意？

三.代码注释的方式

1.单行注释，使用英文符号 #

# python注释代码 1
# python注释代码 2
# python注释代码 3
# python注释代码 4

2.多行注释

方法一：英文状态下使用单引号 ”””

'''
python注释代码 1
python注释代码 2
python注释代码 3
python注释代码 4
'''

方法二：英文状态下使用双引号 “” (和方法一有点类似)

"""
python注释代码 1
python注释代码 2
python注释代码 3
python注释代码 4
"""

方法三：选中单行或者多行，使用快捷键 Ctrl+/

# python注释代码 1
# python注释代码 2
# python注释代码 3
# python注释代码 4

值得注意的是：被注释的代码，程序在执行的时候会直跳过！如下面代码：

# !usr/bin/env python
# -*- coding:utf-8 _*-
"""
@Author:猿说编程
@Blog(个人博客地址): www.codersrc.com
@File:helloworld.py
@Time:2021/3/13 20:37
@Motto:不积跬步无以至千里，不积小流无以成江海，程序人生的精彩需要坚持不懈地积累！
"""
print("hello word")

代码虽多，实际上编译只执行了最后一行代码！被注释的代码，程序自动跳过！