如何才能写出优雅的代码?这是我送给你的 7 点建议 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
推荐学习书目
Learn Python the Hard Way
Python Sites
PyPI - Python Package Index
http://diveintopython.org/toc/index.html
Pocoo
值得关注的项目
PyPy
Celery
Jinja2
Read the Docs
gevent
pyenv
virtualenv
Stackless Python
Beautiful Soup
结巴中文分词
Green Unicorn
Sentry
Shovel
Pyflakes
pytest
Python 编程
pep8 Checker
Styles
PEP 8
Google Python Style Guide
Code Style from The Hitchhiker's Guide
CicadaMan
V2EX    Python

如何才能写出优雅的代码?这是我送给你的 7 点建议

  •  
  •   CicadaMan 2018-07-23 20:11:43 +08:00 2228 次点击
    这是一个创建于 2693 天前的主题,其中的信息可能已经有所发展或是发生改变。

    1、编码规范

    每种编程语言、每个框架都有自己的一套编码规范和编码最佳实践方式,例如 PEP8 是 Python 语言的编码规范,作为 Python 开发者,每个人至少要将 PEP8 读上三五遍,熟记于心并运用在项目中。

    2、文档注释

    程序员最讨厌的两件事情:一,别人的项目没有文档和注释,二,自己的项目要写文档和注释。

    经常看到一些项目连起码的 REAMDME 文件都没有,这跟 demo 没什么区别。如果你的项目没有文档,一旦有新人进来接手也是一脸懵逼,还显得非常业余。所以,一个正经的项目至少要说明项目的是做什么的,用了哪些东西,程序怎么跑起来等等。

    简单的代码自然无需写注释,良好的代码自身就是文档和注释,但是如果有较复杂的代码逻辑就必须用注释来加以说明你当时写这段代码是如何思考的,否则隔两个月自己都不知道写的什么烂代码,还在骂这是哪个傻逼写的。所以,我们写注释应该在该写的时候才写,写多了或者写少了都不合适。还有一种情况就是过期的注释,需求变更代码更新后,发现注释还是旧的。

    虽然 Python 是一门优雅简洁的语言,但是同样离不开注释的帮助,毕竟,代码是写给人看的。 3、避免重复代码

    软件设计原则里面有个 DRP 原则,就是在一个项目里面不要写重复的代码,如果同样的逻辑出现超过两次,那么你就考虑将它进行封装成为一个函数或者公有方法。过多重复的代码到后面将导致很多潜在的问题,一处有问题,导致处处都有改动。

    4、测试覆盖率

    测试驱动开发( TDD )是目前主流的开发模式,但是我们往往因为项目进度或者懒惰,而将单元测试忽略了。没有单元测试的代码就像一座危楼,你永远都不知道里面有哪些坑,因为一旦改了一处代码,你无法预知对整个系统有什么影响,而单元测试是对代码质量的一种保障,测试覆盖率越高,潜在问题越少。 5、安全意识

    安全问题没发生前都是小事,一旦发生将是不可估量的大事情,几年前 CSDN 这么大一个网站竟然还闹出将密码用明文存储的笑话,可见程序员的安全意思有多低,密码至少要做 HASH 存储并加盐处理。去年时候大疆的程序员将服务器的 key 上传到 github 也是典型的安全意思缺乏。什么东西该同步到代码库什么东西不该放要区分清楚。常见的 web 安全也要清楚,像 SQL 注入,CSRF、XSS 攻击的基本原理以及如何预防等等。

    6、设计与架构

    如果设计架构错了,代码写的再好也白搭,好比建房子设计错了,房子在漂亮也华而不实,可能隐藏重大安全隐患。合理的设计与架构在于根据业务做合理的取舍,遵循逐步演进原则,切忌无脑跟风参考 BAT 规模量级来设计你的系统,好的系统都是演变过来的。抛开业务谈技术都是耍流氓。

    7、学习交流分享

    分享你的所得,和比你厉害的人多交流。

    3 条回复    2018-07-25 15:36:13 +08:00
    KKKKKK
        1
    KKKKKK  
       2018-07-24 00:52:26 +08:00 via iPhone
    第零点,良好的排版
    CicadaMan
        2
    CicadaMan  
    OP
       2018-07-24 09:48:40 +08:00
    @KKKKKK 谢谢。
    netStand
        3
    netStand  
       2018-07-25 15:36:13 +08:00
    已收藏。
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     2033 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 23ms UTC 00:57 PVG 08:57 LAX 16:57 JFK 19:57
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86