有没有办法在 Visual Studio Code 中折叠/折叠 Rust 文档注释？

Question

在 VSCode 中，有没有办法折叠/折叠 Rust 文档注释（即以：//!和开头的换行符注释///）？Swift 有类似的评论，因此任何与 Swift 有关的答案也可能与 Rust 相关。

如果 VSCode 本身不支持此功能，是否有任何扩展可以实现相同的功能？

Answer 1

我也很担心这个问题，所以我环顾四周。令人惊喜的是，自 2018 年 3 月以来，由于新的折叠提供程序 API，可以实现这一点。

我做了一些 POC（代码很糟糕而且不安全，不打算按原样使用）：

class CommentProvider implements vscode.FoldingRangeProvider {
    // This method must return a list of the foldable ranges
    provideFoldingRanges(document: vscode.TextDocument, context: vscode.FoldingContext, token: vscode.CancellationToken): vscode.ProviderResult<vscode.FoldingRange[]> {
        let ret: vscode.FoldingRange[] = [];
        for (let i = 0; i < document.lineCount; ++i) {
            let line = document.lineAt(i).text.trim();
            if (line.startsWith("//!")) {
                let from = i;
                do {
                    ++i;
                } while (document.lineAt(i).text.trim().startsWith("//!"));
                ret.push(new vscode.FoldingRange(from, i - 1));
            }
        }
        return ret;
    }
}

export function activate(context: vscode.ExtensionContext) {
    let sel: vscode.DocumentSelector = { scheme: 'file', language: 'rust' };
    let pro = new CommentProvider();
    vscode.languages.registerFoldingRangeProvider(sel, pro);
}

并且必须在以下位置正确注册package.json：

"activationEvents": [
    "onLanguage:rust"
],
"contributes": {
    "languages": [
        {
            "id": "rust",
            "aliases": [
                "rs"
            ],
            "extensions": [
                "rs"
            ],
            "configuration": "./language-configuration.json"
        }
    ]
},

不过，我不确定这些价值观。

最好的办法是要求进行官方 Rust 扩展的团队来集成这一点。