Google Python风格指南
http://www.yeolar.com/note/2013/01/10/python-style-guide/
?
优点:使用Python布尔值的条件语句更易读也更不易犯错. 大部分情况下, 也更快.缺点:对C/C++开发人员来说, 可能看起来有点怪.结论:TypePublicInternalModuleslower_with_under_lower_with_underPackageslower_with_under?ClassesCapWords_CapWordsExceptionsCapWords?Functionslower_with_under()_lower_with_under()Global/Class ConstantsCAPS_WITH_UNDER_CAPS_WITH_UNDERGlobal/Class Variableslower_with_under_lower_with_underInstance Variableslower_with_under_lower_with_under (protected) or __lower_with_under (private)Method Nameslower_with_under()_lower_with_under() (protected) or __lower_with_under() (private)Function/Method Parameterslower_with_under?Local Variableslower_with_under?main和__main__
Tip
即使是一个打算被用作脚本的文件, 也应该是可导入的. 并且简单的导入不应该导致这个脚本的主功能(main functionality)被执行, 这是一种副作用. 主功能应该放在一个main()函数中.
在Python中, pychecker, pydoc以及单元测试要求模块必须是可导入的. 你的代码应该在执行主程序前总是检查 if __name__ == '__main__' , 这样当模块被导入时主程序就不会被执行.
def main(): ...if __name__ == '__main__': main()
所有的顶级代码在模块导入时都会被执行. 要小心不要去调用函数, 创建对象, 或者执行那些不应该在使用pychecker或pydoc时执行的操作.
来源: http://code.google.com/p/zh-google-styleguide/