Python 学习笔记 05｜Python 核心基础 · 注释

3. 注释

3.1. 概述

注释是对代码的备注和解释，在代码执行的时，通常不起任何作用。

3.2. 注释的作用

注释的核心作用如下：

• 提高代码的可读性，通常用来辅助程序员快速理解代码的逻辑。
• 屏蔽掉暂时不需要的代码。

📢注意：在代码中编写清晰易懂的注释，是程序员的基本素养之一！

3.3. 单行注释

在 Python 中#后的一行内内容，会被视为注释。

# name 是张三的名字
name = '张三'
# age 是张三的年龄
age = 18
# weight 是张三的体重（单位：kg）
weight = 65.2

print(name, age, weight)  # 这是一句打印

关于注释的书写格式：

• Python官方建议：在#和注释的内容之间加一个空格，在代码和#之间加两个空格。
• 上述的规则属于 Python 编码规范，规范的具体内容，我们会在课程中逐渐给各位渗透。

3.4. 多行注释

多行注释又称“块注释” ，Python 中的多行注释使用的是一组三引号（单引号，双引号都可以）。

1️⃣多行注释可以换行，但不能嵌套。

"""
我是一些注释
我还是一些注释
"""

2️⃣多行注释本质是一个多行字符串。

📢注意：Python 中并没有真正的多行注释语法，所谓多行注释的本质其实还是字符串。

print(
    """
    Hello World
    Hello world
    """
)

3.5. 文件编码注释

文件编码又称“字符编码”，文件编码注释写在 Python 文件的首行，是一种特殊的注释。

它的作用是：指定当前文件的字符编码。

# coding=utf-8
print('你好啊！')

4. 字符编码

4.1. 概述

计算机对数据会进行两个常见的操作，分别是：存储数据、读取数据。

• 存储数据时，计算机会进行编码。
• 读取数据时，计算机会进行解码。

编码与解码，会遵循一定的规范，这个规范就是字符编码，并且编码与解码，必须遵循相同的编码规范，若所用的规范不一致，就会出现乱码。

# coding=iso-8859-1
print('你好啊！')  # ä½ å¥½å•Šï¼

4.2. 常见编码方式

1. ASCII：大写字母、小写字母、数字、一些符号，共计 28个字符。

2. ISO 8859-1：在ASCII基础上扩展，支持西欧语言，共计 256 个字符。

3. GB2312：中国国家编码标准，收录约 6763 个简体中文常用汉字和符号。

4. GBK：兼容GB2312，进一步扩展，支持简繁体中文和其他汉字，共收录 2 万多个字符。

5. UTF-8：国际通用的编码格式，也叫“万国码”，支持世界所有语言的字符，包括：中文、英文、阿拉伯文、日文、韩文等，向下兼容ASCII，是现代互联网最常用的编码格式。

✅最佳实践：实际开发中，几乎都采用UTF-8编码保存文件。

📋备注：在 Python3 中，可以不写文件编码声明，因为 Python3 默认就使用UTF-8编码。