2.5 注释

1. 语法

语法: 是编程语言编写代码的规则, 学习编程就是学习它的语法.
Python 的基础语法包括: 注释, 变量, 赋值, 输入, 输出, 缩进, 表达式等.
1
2

2. 语句

语句: 在代码中, 能够完整表达某个意思的最短代码.
Python 中语句可以使用 ';' 分号, 换行表示一个语句语句结束.
1
2

print 后面紧跟着一对圆括号, 将需要打印的内容填写在括号内用引号引起来,
就可以在运行工具窗口打印出你想要的内容.
* 没有特殊情况, 每一行代码必须顶格书写.
1
2
3

print('Hello'); print('World!')

print('Hello')
print('World!')

1
2
3
4
5

Pycharm 会检测代码的语法, 当检测代码不符合规范会提示.
Pycharm 中分号 ';' 飘黄, 提示不符合 PEP8 规范.
1
2

PEP 8 规范要求:
英 PEP 8: E702 multiple statements on one line (semicolon), 
中 PEP 8: E702 一行多个语句(分号)
* 不推荐使用 ; 号在一行写多条语句.
1
2
3
4

将分号 ';' 删除, 将后面的语句换到下一行中.
1

print('Hello')
print('World!')

print('Hello')
print('World!')

1
2
3
4
5
6

3. 编码规范

规范是多数程序员共同遵守的一种编码风格, 因为实际开发过程中都是以团队合作形式开发,
而且几乎每个程序员都有自己的个人风格和习惯, 那么这时要想高效率开发, 规范约束则很有必要的.
1
2

Python 采用 PEP 8 作为编码规范.
PEP 是 Python Enhancement Proposal的缩写, 8 代表的是 Python 代码的样式指南.

官方 PEP 8 规范链接: https://peps.python.org/pep-0008/
1
2
3
4

Pycharm 编辑器会检测代码编写是否规范, 不规范的话提示, 如: 飘黄, 飘红, 高亮, 波浪线等.
Pycharm 支持按照 PEP 8 自动格式化代码.
快捷键: Ctrl + Shilt + Alt + L  唤出格式化文件面板.
快捷键: Ctrl + Alt + L 按默认配置直接格式化文件.
1
2
3
4

4. 空行

空行也是程序代码的一部分, 空行会被解释器忽略, 
常用于分隔两段不同功能的代码, 便于日后代码的维护或重构.
1
2

print('Hello')
print('World!')

print('Hello')
print('World!')
1
2
3
4
5

语句结束处飘黄.
1

PEP 8 规范要求:
英 PEP 8: W292 no newline at end of file
中 PEP 8: W292文件末尾无换行符
* 换行符会在下面新建一行, 脚本文件结束需要有一空行.
1
2
3
4

在脚本末尾新建一空行.
1

print('Hello')
print('World!')

print('Hello')
print('World!')

1
2
3
4
5
6

5. 注释

5.1 注释的作用

注释是对代码的解释与说明, 其目的是让人们能够更加容易的理解代码.
被注释的代码不参与代码的解释, 不会被执行.

* 注释不会占用内存, 会占用硬盘空间, 注释过多会影响载入内存的速度.
1
2
3
4

5.2 注释格式

注释格式: 以 '#' 号开头, 后面写注释信息, 只能在当前行写不能跨行书写. 
1

print("Hello World!")#你好呀!

1
2

注释语句飘黄.
1

PEP8 规范要求: 
英 PEP 8: E261 at least two spaces before inline comment
中 PEP 8: E261 内联注释前至少两个空格
* '#' 与代码间隔2格. 

英 PEP 8: E262 inline comment should start with '# '
中 PEP 8: E262 内联注释应以“# ”开头
* '#' 号与注释信息间隔1格.  
1
2
3
4
5
6
7
8

注释与代码间隔2格, 以 '# '开头, 后面写注释.
1

print("Hello World!") # 你好呀!

1
2

5.3 快捷注释

PyCharm 中,  ctrl + / 加上注释, 在次按下ctrl + / 解开注释. 
* 选中一行就单行注释, 选中多行就多行注释.
1
2

6. 特殊声明

在一些 .py 脚本文件的开头都能看以下两行:
1

#!/usr/bin/env python
# -*- coding:utf-8 -*-
...
1
2
3

这两行不是注释而是一些特殊设定.
1

6.1 解释器相关

第一行: 声明运行脚本的使用的解释器, Linux专用.

# 号后面加上 ! 并强制指定解释器, 找不到解释器会报错.
Linux 下脚本使用 ./test.py 的方式执行, 使用 python test.py 的方式这一行不起作用.

* Windows 中 使用 Pycharm 创建项目时就, 选择了使用的的 Python 解释器.
1
2
3
4
5
6

6.2 编码相关

第二行: 声明代码的编码方式, 代码文件保存使用的字符编码.
Python3 使用 UTF-8 编码.
Python2 使用 ASCII 编码, 脚本文件中仅支持英文, 如果出现中文, 运行时会出现非 ASCII 错误.
1
2
3

6.3 非 ASCII 错误

# 注释
print('Hello World!')

1
2
3

Pycharm 切换解释器为 Python 2.7 .
1

中文注释高亮, 提示脚本文件没有声明编码.
1

解释器检测语法时, 会报错并提示错误的原因, 学会查看错误提示是学习编程的基本技能.
1

程序执行之后报错:
英 SyntaxError: Non-ASCII character '\xe6' in file 
中 语法错误：文件中的非 ASCII 字符“\xe6”
1
2
3

6.4 指定编码

指定编码方式:
* 1. # coding=UTF-8
* 2. # coding:UTF-8
* 3. # coding=UTF8
* 4. # coding:UTF8
* 5. # coding:UTF
* 6. # -- coding:UTF8 -- 
    '--'是装饰符号, 还可以使用其它的字符.
...
1
2
3
4
5
6
7
8
9

* 文件声明编码, 没有声明前不能出现中文!!!
1

# coding=UTF8
print('Hello World!')

1
2
3

7. 符号

Python 程序内所有的符号, 除了字符串的内容以外, 必须是英文半角符号, 否则抛出异常.
英 SyntaxError: invalid character '“' (U+201C)
中 语法错误：无效字符 “” (U+201C)
1
2
3

print(“”)

1
2

---

文章的段落全是代码块包裹的, 留言0是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言1是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言2是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言3是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言4是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言5是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言6是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言7是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言8是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言9是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言10是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言11是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言12是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言13是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言14是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言15是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言16是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言17是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言18是为了避免文章提示质量低.
文章的段落全是代码块包裹的, 留言19是为了避免文章提示质量低.

---