写出一手烂代码的19条准则( 二 )


 
第十条:Type 使用需谨慎
一般不要指定变量类型或者经常做类型检查 , 无类型才是最好的类型 。

写出一手烂代码的19条准则

文章插图
 
第十一条:准备「Plan B」
你需要准备一些运行不到的代码(unreachable code) , 它们可以作为你的「Plan B」 。
写出一手烂代码的19条准则

文章插图
 
第十二条:嵌套的三角法则
如果代码有一些嵌套结构 , 或者说缩进空行的结构 , 三角法则是最漂亮的 。
写出一手烂代码的19条准则

文章插图
 
第十三条:混合缩进
我们需要避免采用缩进 , 因为缩进会使复杂代码在编辑器中占用更多的空间 。如果一定要采用缩进 , 那么就使用混合缩进策略 。当然 , 这种策略在 Python 中是行不通的 , 因为它靠缩进来确定代码结构 。
写出一手烂代码的19条准则

文章插图
 
第十四条:不要锁住依赖项
每一次要安装新库时 , 更新已有的依赖项 。为什么要维持之前的版本呢 , 我们需要时刻保持最新的第三方代码库 。
写出一手烂代码的19条准则

文章插图
 
第十五条:长函数比短函数好
不要将程序整体逻辑分割为一些代码块 , 要是 IDE 突然不行了 , 它找不到必要的文件或函数怎么办 。因此把代码写在一个主体函数中 , 并且不再维护额外的函数导入或代码文件 , 那么这样的方法是最稳定的 。
单个文件一万行代码是没问题的 , 单个函数一千行代码也是没问题的 。
第十六条:代码不需要做特定测试
这些测试通常是重复且无意义的工作 。
第十七条:尽量避免重复代码
按你的想法写代码 , 尤其是在小团队中 , 毕竟这是「自由」准则 。
第十八条:构建新项目不需要 README 文档
在项目前期 , 我们可以暂时保持这种状态 。
第十九条:保存不必要的代码
在写代码的过程中 , 经常会产生很多测试代码 。这些代码也是非常重要的资料 , 因此不能删除掉 , 最多只能注释掉 。




推荐阅读