如何使用 Pylint 来规范 Python 代码风格

核心提示： --files-output=<y_or_n>将每个 module /package 的 message 输出到一个以 pylint_module/package. [txt|html] 命名的文件中，如果有 report 的话，如何使用 Pylint 来规范 Python 代码风格

--files-output=<y_or_n>

将每个 module /package 的 message 输出到一个以 pylint_module/package. [txt|html] 命名的文件中，如果有 report 的话，输出到名为 pylint_global.[txt|html] 的文件中。默认是输出到屏幕上不输出到文件里。

-f <format>, --output-format=<format>

设置输出格式。可以选择的格式有 text, parseable, colorized, msvs (visual studio) 和 html, 默认的输出格式是 text。

--disable-msg=<msg ids>

禁止指定 id 的 message. 比如说输出中包含了 W0402 这个 warning 的 message, 如果不希望它在输出中出现，可以使用 --disable-msg= W0402

Pylint 的输出

Pylint的默认输出格式是原始文本（raw text）格式 ，可以通过 -f <format>，--output-format=<format> 来指定别的输出格式如html等等。在Pylint的输出中有如下两个部分：源代码分析部分和报告部分。

源代码分析部分：

对于每一个 Python 模块，Pylint 的结果中首先显示一些"*"字符 , 后面紧跟模块的名字，然后是一系列的 message, message 的格式如下：

　MESSAGE_TYPE:　LINE_NUM:[OBJECT:]　MESSAGE　

MESSAGE_TYPE 有如下几种：

(C) 惯例。违反了编码风格标准

(R) 重构。写得非常糟糕的代码。

(W) 警告。某些 Python 特定的问题。

(E) 错误。很可能是代码中的错误。

(F) 致命错误。阻止 Pylint 进一步运行的错误。

清单 2. Pylint 中的 utils 模块的输出结果
　*************　Module　utils　
　C:　88:Message:　Missing　docstring　
　R:　88:Message:　Too　few　public　methods　(0/2)　
　C:183:MessagesHandlerMixIn._cat_ids:　Missing　docstring　
　R:183:MessagesHandlerMixIn._cat_ids:　Method　could　be　a　function　
　R:282:MessagesHandlerMixIn.list_messages:　Too　many　branches　(14/12)