swift - Jazzy 无法解析 .swift 文件

Question

我正在尝试创建 Xcode 项目的文档，但遇到了一个非常奇怪的问题，我无法解决。

我下载了 Jazzy 作为创建文档的工具。我评论/记录了几个没有问题的文件，但其中一个文件却无法解析它。我读过几个 Github 和 StackOverflow 线程，但没有一个能解决我的问题。我尝试弄乱访问级别标志，强制包含甚至排除 jazzy 文件，然后重新安装整个 jazzy。以上均无效。

当我尝试在项目中运行 jazzy --min-acl inside (或任何访问级别或 jazzy)时，它会解析 13/39 个文件。在第 14 处，它停止并抛出此错误:

Parsing LoginViewController.swift (14/39)
from /Library/Ruby/Gems/2.3.0/gems/jazzy-0.10.0/lib/jazzy/sourcekitten.rb:230:in `run_sourcekitten'
from /Library/Ruby/Gems/2.3.0/gems/jazzy-0.10.0/lib/jazzy/doc_builder.rb:65:in `block in build'
from /Library/Ruby/Gems/2.3.0/gems/jazzy-0.10.0/lib/jazzy/doc_builder.rb:63:in `chdir'
from /Library/Ruby/Gems/2.3.0/gems/jazzy-0.10.0/lib/jazzy/doc_builder.rb:63:in `build'
from /Library/Ruby/Gems/2.3.0/gems/jazzy-0.10.0/bin/jazzy:15:in `<top (required)>'
from /usr/local/bin/jazzy:22:in `load'
from /usr/local/bin/jazzy:22:in `<main>'

这一切让我感到非常困惑，因为我知道之前一切都运行得很好。这意味着我破坏了某些东西，我不知道更改任何设置。我只是在编写文档的过程中更改了一些代码。但这背后的原因似乎很奇怪。另外 - 已经记录的文件工作得很好，只是这个不行。

任何提示或帮助将不胜感激!谢谢

Answer 1

我有评论说

//MARK - TextField delegate methods

而不是

//MARK: - TextField delegate methods

尽管这听起来多么愚蠢，但它似乎导致了这个问题。