最新全面的『Python编码规范』_代码重构火葬场(1)，头条面试一般几轮

最后

🍅 硬核资料：关注即可领取PPT模板、简历模板、行业经典书籍PDF。
🍅 技术互助：技术群大佬指点迷津，你的问题可能不是问题，求资源在群里喊一声。
🍅 面试题库：由技术群里的小伙伴们共同投稿，热乎的大厂面试真题，持续更新中。
🍅 知识体系：含编程语言、算法、大数据生态圈组件（Mysql、Hive、Spark、Flink）、数据仓库、Python、前端等等。

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化学习资料的朋友，可以戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

4. 在每一个 py 文件头，都添加如下内容：

#!/usr/bin/env python
# -*- coding: utf-8 -*-
#
 

# 只导入 future 空间的这两个特性就够了，其他特性容易造成其他方面的『不兼容』，没有使用的必要性。
from __future__ import (absolute_import, unicode_literals)

【强制】【命名】

1. class，function 该如何命名，不赘述，严格照着PEP8做就行了，不用多想。
2. 全局变量（全局变量，一般是常量，我们认为：凡是全局的，都是常量），应该始终使用全大写，如：

GLOBAL_PUBLIC = "G1"
_GLOBAL_PRIVATE = "G2"

**class** **Person**:
    _GLOBAL_IN_CLASS = 'G3'
    

按照这条要求，其实很多库**or**开源库，都是不符合要求的。为什么这么强硬呢？
Python中的变量定义，是不分『声明』、『定义』、『初始化』、『赋值』这几个概念的，所以一个
a = 1
如果没有上下文，你是很难确定其作用域的，也很难确定 这到底是初始化还是赋值（a已经存在过），
如果全局变量还不用全大写，带来的麻烦只会更多。

如果始终坚持这个原则，将会给代码的可读性带来极大提升。

1. 定义枚举，始终加 Enum后缀；定义异常始终加Exception后缀；定义mixin，始终加Mixin后缀，如

**class** **DirectionEnum**:
    UP = 1
    DOWN = 2
    
    
**class** **MyException**(Exception):
    **pass**
**class** **MyError**(Exception):
    **pass**
    
**class** **SomeMixin**:
    **pass**

【强制】【强化private的概念】

即：最小知识原则，对外暴露的东西越少越好

翻译成大白话就是：
1. 实例属性，一般定义成private的
2. **class**，对外提供的方法越少越好
3. **module**，对外提供的接口越少越好
4. package，对外提供的 **module** 越少越好

翻译成代码就是：
1. 项目布局
package/
    __init_\_.py
    _private_mod.py
    public_mod.py    
    
2. 某模块内容
public_mod.py
PUBLIC_GLOBAL = 'G1'
_PRIVATE_GLOBAL = 'G2'
**class** **\_Class**:
    pass
**class** **PublicClass**:
    _PRIVATE_GLOBAL = 'G3'
    
    **def** **\_\_init\_\_**(**self**, name,age):
        **self**._name = name
        **self**._age = age
    **def** **public\_method**(**self**):
        pass
    **def** **\_private**(**self**):
        pass
        

所有东西，一开始就要定义成私有的，等到确实需要开放访问了，才开放出去。

【强制&重要】【关注公开接口的复杂性】

最好的接口是这样的，调用者无脑使用
**def** **interface**():
    **pass**
    
次等接口是这样的
**def** **interface**(param1):
    **pass**
    
次次等接口是这样的
**def** **interface**(p1, p2):
    **pass**

最大忍受限度的接口是这样的
**def** **interface**(p1, p2, p3='SOME DEFAULT'):
    **pass**
**def** **interface**(p1, *args):
    **pass**
    
不可接受的接口是这样的
**def** **interface**(p1, p2, **kwargs):
    **pass**

令人无语的接口是这样的
**def** **interface**(*args, **kwargs):  
# 尽量不要使用 \*\*kwargs， 某些流行库有这样的毛病，我是觉得：极大地增加了调用者的心理负担，反映了接口设计者的懒惰
    **pass**
    
一直觉得，**kwargs只适用于极少数明确的场合，并且需要辅以很明确的文档说明（解释为什么要使用），然而现实是，这个
特性已经被大家滥用了，有必要单独说明之。

【推荐】【以package去设计命名空间，而不是基于module】

【推荐】【了解如下内容】

**\_\_init\_\_**.py 的作用

**\_\_main\_\_**.py 的作用

if **\_\_name\_\_** == '**\_\_main\_\_**': 的作用

Python的命名空间加载机制，即：sys.path sys.modules 的内容

【推荐】【合理设计项目目录结构】

做了那么多年开发，自学了很多门编程语言，我很明白学习资源对于学一门新语言的重要性，这些年也收藏了不少的Python干货，对我来说这些东西确实已经用不到了，但对于准备自学Python的人来说，或许它就是一个宝藏，可以给你省去很多的时间和精力。

别在网上瞎学了，我最近也做了一些资源的更新，只要你是我的粉丝，这期福利你都可拿走。

我先来介绍一下这些东西怎么用，文末抱走。

---

（1）Python所有方向的学习路线（新版）

这是我花了几天的时间去把Python所有方向的技术点做的整理，形成各个领域的知识点汇总，它的用处就在于，你可以按照上面的知识点去找对应的学习资源，保证自己学得较为全面。

最近我才对这些路线做了一下新的更新，知识体系更全面了。

（2）Python学习视频

包含了Python入门、爬虫、数据分析和web开发的学习视频，总共100多个，虽然没有那么全面，但是对于入门来说是没问题的，学完这些之后，你可以按照我上面的学习路线去网上找其他的知识资源进行进阶。

（3）100多个练手项目

我们在看视频学习的时候，不能光动眼动脑不动手，比较科学的学习方法是在理解之后运用它们，这时候练手项目就很适合了，只是里面的项目比较多，水平也是参差不齐，大家可以挑自己能做的项目去练练。

（4）200多本电子书

这些年我也收藏了很多电子书，大概200多本，有时候带实体书不方便的话，我就会去打开电子书看看，书籍可不一定比视频教程差，尤其是权威的技术书籍。

基本上主流的和经典的都有，这里我就不放图了，版权问题，个人看看是没有问题的。

（5）Python知识点汇总

知识点汇总有点像学习路线，但与学习路线不同的点就在于，知识点汇总更为细致，里面包含了对具体知识点的简单说明，而我们的学习路线则更为抽象和简单，只是为了方便大家只是某个领域你应该学习哪些技术栈。

（6）其他资料

还有其他的一些东西，比如说我自己出的Python入门图文类教程，没有电脑的时候用手机也可以学习知识，学会了理论之后再去敲代码实践验证，还有Python中文版的库资料、MySQL和HTML标签大全等等，这些都是可以送给粉丝们的东西。

这些都不是什么非常值钱的东西，但对于没有资源或者资源不是很好的学习者来说确实很不错，你要是用得到的话都可以直接抱走，关注过我的人都知道，这些都是可以拿到的。

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化学习资料的朋友，可以戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！