Python编程规范和格式化工具

本文介绍了Python编程规范PEP8,包括代码可读性、缩进、行宽、空行使用等规则,并提供了PEP8的极简版。此外,还探讨了自动格式化工具YAPF和Black,它们能帮助开发者遵循PEP8规范,统一代码风格。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

摘要:

PSF & PEP

PSF(Python Software Foundation),Python的官方组织。PSF 提供的文档包括:

PEP 是 PSF 写出、收纳、提供给社区参考使用、包含新特性、规范性等内容的说明文档。

PEP在 github 上撰写、管理,自动编译html、同步到 网站 上,从2000年开始创建,至今(2019.5)仍非常活跃,如果是python的developer,建议star或watch它,实时跟踪。

PEP分了8类: 核心类、已提交、已接收、讨论中、讨论完、归档、拒绝、废弃 。

  • 有些pep很庞大,如:pep8(python编程规范);也有些很简短,如:pep7(c编程规范)
  • 有些pep很一本正经,如:pep569(Python 3.8 Release Schedule);有些也很搞怪,如:pep20(Zen of Python,20条禅学)

要贡献 PEP,需要参考 pep12 的模板来写,并且 PEP 不是用 markdown 写的,而是 ReStructuredText,也是标记(markup)语言,语法比 markdown 稍复杂一点点,这里有一些语法说明:

普通 Python 开发人员必读的PEP有:

  • 编码规范
    • PEP8 :Python 编码规范
    • PEP7 :C 编码规范
  • 文档规范
    • PEP256 :文档系统工作机制
    • PEP257 :docstrings Conventions
    • PEP258 :注释与文档转换工具
    • PEP287 :reStructuredText 书写规则

PEP8 Style Guide for Python Code

核心类 pep 是 PEPs of PEPs,目前只有9个, PEP8 位列其中,内容是 Python 的编码规范,Python开发人员必读文档之一。

PEP8 从2001年创建,至今有141次提交:

修改(提交)集中

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值