PyCodeStyle崇高文本3注释行长度

Question

我成功地设置了Sublime Text 3来处理SublimeLinter和{a2}。我喜欢用它来保持我的诚实，我已经为PyCodeStyle设置了sublimeliner配置文件，以忽略某些警告。这是我现在的档案。在

{
"linters": {
"pycodestyle": {
  "ignore": ["E111", "E114"],
  "max-doc-length": 60,
},
// ... other linters' settings
}

我忽略了E111和E114，因为在我的项目中，我必须使用2的缩进宽度，我不想因为没有使用4的倍数而不断受到指责。在

我遇到的问题是第二个命令，我的目标是在注释行太长时得到警告。我把它设为60（尽管PEP提出了72个建议，我打算使用它），只是为了迫使它绊倒。在

不管我把它设置成什么，我都不会得到我期望得到的警告（W505:doc line too long）。（我从未收到任何警告。）我也尝试过“-max doc length”和“-max doc length”，因为我知道在通过命令行执行时，后者是可选的。在

有人知道我做错了什么吗？当我的评论太长的时候，我如何说服林特给我一个严厉的教训？在

可能是版本问题吗？我注意到我可以在PyCodeStyle's webpage（search for“--max doc length=n”）上看到上面引用的选项；但是，在我的系统中，当我键入pycodestyle --help时，我看不到这个选项。我看到了--max-line-length=n选项，但没有看到它下面的doc行。在

pycodestyle --version的输出是2.4.0。在

Answer 1

首先，是的，有一个版本问题。即使您有最新版本（2.4.0，released on 10 Apr 2018），仍然添加了max-doc-length，after that version was released, on 11 May 2018。在

我不知道为什么它被添加到2.4.0的文档中，而它在那里不可用（可能是因为他们还没有将回购中的版本升级到2.4.1？），但我不确定这是否值得报告。在

不管怎样，如果你想要这个特性（又不想等待下一个版本），你必须在GitHub上安装最新版本。在

---

不过，我觉得你无论如何都不想使用这个功能。在

max-doc-length（以及相应的W505警告）用于docstring，而不是用于注释。所以，它仍然无法检测到你的评论行太长。在

据我所知，pycodestyle没有任何方法为注释指定不同的长度；它们总是得到max-line-length。在