笔记 | PYTHON

晓松

职位：运维开发工程师
技能：熟练Centos系统操作、管理和维护
技能：熟悉 MySQL 数据库基本使用方法
技能：熟练 SHELL 脚本的编写
技能：熟悉 LNMP 平台相关技术配置和管理
技能：熟悉 ZABBIX 监控系统的配置和使用
技能：熟悉 Prometheus 监控系统的安装配置和使用
技能：熟悉 ansible 自动化运维工具
技能：了解 HTML,CSS,JavaScript前端页面基本编写
技能：熟悉 WAF 应用防火墙的使用和配置
技能：熟悉 Linux7 firewall 防火墙的使用
技能：熟悉阿里云平台的使用
技能：熟悉Docker虚拟化技术
技能：熟悉 Redis、MongoDB NoSQL数据库使用

### 代码书写规范

#### 缩进

程序设计强调“清晰第一，效率第二”，应注意程序代码书写的格式。

- 用4个空格来缩进代码，绝对不要用tab, 也不要tab和空格混用
- 对于行连接的情况, 你应该要么垂直对齐换行的元素
- 或者使用4空格的悬挂式缩进

```python
foo = long_function_name(
    var_one, var_two, var_three,
    var_four)
```

#### 逻辑行与物理行

Python 中的每个语句以换行结束
一个物理行中若使用多于一个逻辑行

- 即多条语句书写在一行
- 则使用分号";"
- **但是！不推荐**
- **不要在行尾加分号, 也不要用分号将两条命令放在同一行**

#### 注释

注释可以帮助读者思考每个过程、每个函数及每条语句的含义

- 便于编程员相互讨论
- 有利于程序的维护和调试

程序的注释分为序言性注释和功能性注释

- 序言性注释

> 位于每个模块开始处
> 作为序言性的注解，简要描述模块的功能、主要算法、接口特点、重要数据及开发简史

- 功能性注释

> 插在程序中间，与一段程序代码有关的注解
> 是针对一些必要的变量、核心的代码进行解释
> 主要解释这段代码的功能

Python 注释的约定

- 注释可以添加在代码中的任何位置，但不能添加在字符串中
- 若要将注释追加到某语句，可在该语句后插入一个 # 号，后面添加注释
- 注释可以位于单独的行中，一般位于所要注释的代码上一行

**单行注释（行注释）**

- Python 中的 # 表示单行注释
- 单行注释可以作为单独的一行放在被注释代码行之上
- 也可以放在语句或表达式之后

**多行注释（块注释）**

- Python 中使用3个单引号或3个双引号表示多行注释
- 用于注释内容过多，一行无法显示时

#### 编码风格

良好的编码风格有助于编写出可靠、易于维护的程序
在很大程度上决定着程序的质量

- 常用的编码风格

> 复杂的表达式使用“括号”优先处理，避免二义性
> 单个函数的代码量最好不要超过100行
> 尽量使用标准函数和公共函数
> 不要随意定义全局变量，尽量使用局部变量
> 保持注释与代码完全一致，修改了代码不要忘记修改注释
> 循环、分支层次最好不要超过5层
> 在变程序前，尽可能化简化表达式
> 仔细检查算法中嵌套的循环，尽可能将某些语句或表达式移到循环外面
> 尽量避免使用多维数组
> 避免混淆数据类型
> 尽量采用算术表达式和布尔表达式
> 保持控制流的局部性和直线性

晓松

python 代码书写规范 python 程序的常见书写规范

python 代码书写规范

python 程序的常见书写规范