3. 注释

3.1. 概述

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

3.2. 注释的作用

注释的核心作用如下：

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

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

3.3. 单行注释

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

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

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

关于注释的书写格式：

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

3.4. 多行注释

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

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

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

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

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

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

3.5.  文件编码注释

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

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

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