注册 登录
Python基础教程

第一章: 环境搭建,安装Python

第二章: 挑选一款趁手的IDE

第三章: 计算机基础知识

第四章: 命令行基础知识

第五章: 从全局把握Python

第六章: Python语言基础

第七章: Python流程控制

第八章: Python数据类型与运算

第九章: Python字符串类型

第十章: Python列表类型

第十一章: Python元祖类型

第十二章: Python字典类型

第十三章: Python集合类型

第十四章: Python函数处理

第十五章: Python文件处理

第十六章: Python面向对象

第十七章: Python异常处理

第十八章: Python模块处理

第十九章: Python项目实战

首页 > Python基础教程 > 第六章: Python语言基础 > 6.3节: 学会写代码注释

6.3节: 学会写代码注释

薯条老师 2020-04-21 15:33:28 207627 0

编辑 收藏

广州番禺Python, Java小班周末班培训

薯条老师在广州做Python和Java的小班培训,一个班最多10人,学员的平均就业薪资有11K。不在广州的同学可以报名线上直播班,跟线下小班的同学们同步学习。培训的课程有Python爬虫,Python后端开发,Python办公自动化,Python大数据分析,Python量化投资,Python机器学习,Java中高级后端开发。授课详情请点击:http://chipscoco.com/?cate=6

6.3.1 理解代码注释

在程序的编写过程中,通常会写注释,用来对关键的代码或程序中复杂的逻辑进行描述。代码注释面向的是程序员,也就是说它是给程序员看的。Python解释器在解释执行程序中的指令时,会跳过代码中的注释内容。

同学们在一开始学习编程的时候,就要养成写代码注释的习惯,将程序中关键的逻辑通过文字描述记录下来。这样在以后阅读的过程中,可以通过注释来理解程序中的关键逻辑。当然也不要过度注释,否则会影响代码的整体可读性。

6.3.2 代码注释符号

Python中的注释符号有英文中的三引号:
'''注释内容'''
"""注释内容"""
和英文的#符号:

# 后面的都是注释内容
#符号用来作单行注释,例如以下的代码:
state = 0
# 判断变量state指向的值是否等于0,如果等于0就执行冒号下方的代码
if state == 0:
   # 如果state指向的值等于0,就执行print("开心")
   print("开心")
else:
   # 否则执行print("不开心")
   print("不开心")

#符号用来进行单行注释,在Python中进行多行注释,需要使用一对英文的三引号'''或""",三引号括住的即为注释内容。使用三引号进行多行注释的代码实例:

state = 0
# 判断变量state指向的值是否等于0
if state == 0:
   """
   如果变量state指向的值为0,
   就执行print("开心")
   """ 
   print("开心")
else:
   """
   否则执行print("开心")
   """ 
   print("不开心")

Python解释器在解释执行脚本程序时,会跳过代码中的注释内容。对于Python解释器来说,程序中的代码相当于以下形式(不包含任何代码注释):

state = 0
if state == 0:
    print("开心")
else:
    print("不开心")

6.3.3 文件编码注释

Python源程序文件是文本文件,文本文件是由文本字符构成的文件,所谓的文件编码,是指文本文件中的字符编码方式。在Python版本2.X中,默认的字符编码为ASCII编码,如果使用非ASCII字符(例如汉字就是非ASCII字符)进行注释,Python在执行脚本程序时会抛出语法错误的异常信息。

计算机只能处理二进制,为了让计算机也能识别字符,需要将字符使用特定的数字编码进行表示。对此不熟悉的同学们,可以复习5.1节中的内容。

ASCII编码是一种字符编码规范,在这种编码规范中,最多只能表示256个字符。感兴趣的同学们,可以查阅相关资料,来查看ASCII编码所支持的字符。在Python版本3.X中,文件的默认字符编码为utf-8编码,可以直接在代码中使用汉字等其它字符进行注释。通过在文件头部指定编码注释,Python解释器会按照指定的编码方式来对文件的内容进行解码。编码注释主要有以下两种写法:

(1) -*- coding=encoding_name -*-
(2) # coding=encoding_name

encoding_name表示具体的字符编码,例如指定按gbk编码的方式进行编码,写法为:

-*- coding=gbk -*-
# 使用gbk进行编码
state = 0
# 判断变量state指向的值是否等于0
if state == 0:
    """
    如果变量state指向的值为0,
    就执行print("开心")
    """ 
    print("开心")
else:
    """
    否则执行print("开心")
    """ 
    print("不开心")

本教程采用的版本为Python3.7.6, 无需在文件头特别指定字符的编码方式。对于Python2.X系列的版本,同学们可以在文件头中指定utf-8编码:

-*- coding=utf-8 -*-

gbk编码,utf-8编码以及ascii编码都是一种字符编码规范,感兴趣的同学们可以查阅相关资料,将字符的主要编码规范作为课后的学习课题。

6.3.4 最具实力的小班培训

薯条老师在广州做Python和Java的小班培训,一个班最多10人。不在广州的同学可以报名线上直播班,跟线下小班的同学们同步学习打算参加小班培训的同学,必须遵守薯条老师的学习安排,认真做作业和项目。把知识学好,学扎实,那么找到一份高薪的工作就是很简单的一件事。

(1) Python后端工程师高薪就业班,月薪11K-18K,免费领取课程大纲
(2) Python爬虫工程师高薪就业班,年薪十五万,免费领取课程大纲
(3) Java后端开发工程师高薪就业班,月薪11K-20K, 免费领取课程大纲
(4) Python大数据分析,量化投资就业班,月薪12K-25K,免费领取课程大纲

扫码免费领取Python学习资料:

关注微信公众号.jpg



欢迎 发表评论:

请登录

忘记密码我要注册

注册账号

已有账号?请登录