VS中使用Ctrl+M,O无法关闭Regina折叠？

Question

在使用 Visual Studio 编辑 Regina 脚本文件时，部分开发者反馈按下 Ctrl+M, O 快捷键无法正常展开已折叠的代码区域。该问题通常出现在未正确识别语言模式或自定义语法高亮插件干扰的情况下。由于 Regina 使用特殊语法结构（如函数、注释块），VS 可能未能将其识别为支持“全部展开”的标准代码结构，导致“Outlining Collapse to Definitions”功能失效。此外，.rg 或 .rex 文件类型未映射到正确的文本编辑器配置，也会使折叠功能异常。解决方法包括：确认文件关联正确语言服务、禁用第三方插件冲突、重置编辑器大纲设置，或手动执行“编辑 → 折叠”菜单中的“停止大纲显示”再重新启用。

Answer 1

1. 问题现象描述与初步排查

在使用 Visual Studio 编辑 Regina 脚本文件（如 .rg 或 .rex 文件）时，部分开发者反馈按下快捷键 <kbd>Ctrl+M, O</kbd> 后无法正常展开已折叠的代码区域。该功能通常用于“折叠到定义”（Collapse to Definitions），但在 Regina 脚本中经常失效。

• 用户尝试多次触发快捷键无响应
• 菜单项“编辑 → 折叠 → 全部展开”也显示为灰色不可用
• 仅部分代码块可手动折叠/展开，整体大纲控制失灵

此现象表明 Visual Studio 的“大纲显示”（Outlining）机制未能正确识别当前文档的语言结构或未激活相关服务。

2. 根本原因分析：语言模式与文件类型映射

Regina 是一个 Rexx 解释器实现，其脚本语法具有特定结构，例如：

/* 函数定义示例 */
myFunction: procedure
    say "Hello"
return

然而，Visual Studio 默认并不支持 .rg 或 .rex 文件的语言服务。若未通过扩展或配置将其映射至正确的编辑器类型，系统将无法解析函数、注释块等可折叠结构。

文件扩展名	默认语言服务	是否支持大纲
.rg	纯文本	否
.rex	无	否
.cs	C# 语言服务	是

3. 深层技术因素：插件干扰与语法高亮冲突

许多开发者为增强 Regina 脚本的可读性，安装了第三方语法高亮插件（如自定义 TextMate bundle 或 VSIX 扩展）。这些插件可能：

1. 未完整实现 IOutliningManager 接口
2. 注册了错误的内容类型（Content Type）
3. 覆盖了默认的分类器（Classifier）但未提供结构解析器

这会导致即使语法高亮正常，但结构化代码区域（如函数、条件块）无法被识别为可折叠节点。

4. 解决方案路径：从配置到重置

以下是逐步排查和解决该问题的技术路线：

1. 确认文件扩展名已关联到支持大纲的语言服务
2. 检查是否存在冲突的第三方插件并临时禁用
3. 重置 Visual Studio 的编辑器大纲设置
4. 手动启用大纲显示以恢复功能

5. 实施步骤详解

执行以下操作可恢复 Regina 脚本的大纲功能：

1. 打开 Visual Studio，进入“工具 → 选项”
2. 导航至“文本编辑器 → 文件扩展名”
3. 添加扩展名 .rg 并将其关联到“Microsoft Visual Studio LSP Client”或“源代码编辑器”
4. 重启 IDE 使更改生效
5. 打开 Regina 脚本文件，按 <kbd>Ctrl+M, P</kbd> 确保“停止大纲显示”已执行一次
6. 再次执行 <kbd>Ctrl+M, M</kbd> 重新启用大纲
7. 验证 <kbd>Ctrl+M, O</kbd> 是否恢复正常

6. 高级调试方法：使用 MEF 和日志诊断

对于资深开发者，可通过 MEF（Managed Extensibility Framework）查看当前加载的语言服务：

[ImportMany]
IEnumerable<Lazy<ILanguageService, LanguageServiceMetadata>> _services;

同时启用 STrace 日志记录，观察以下事件：

• EditorOutliningManagerProvider 被创建
• BufferGraph 结构是否完整
• ITextBuffer.ContentType 是否包含 "projection" 或自定义类型

7. 可视化流程图：问题诊断与修复路径

graph TD A[Regina脚本折叠功能异常] --> B{文件扩展名是否注册?} B -- 否 --> C[在“文件扩展名”中添加. rg/.rex] B -- 是 --> D{第三方插件启用?} D -- 是 --> E[禁用插件测试] D -- 否 --> F[执行Ctrl+M,P再Ctrl+M,M] F --> G[功能恢复?] G -- 否 --> H[重置VS设置或修复安装] G -- 是 --> I[问题解决]

8. 长期建议与最佳实践

为避免未来出现类似问题，建议采取以下措施：

• 开发专用的 VS Language Server 插件以原生支持 Regina 脚本
• 使用 .editorconfig 文件统一团队编辑行为
• 定期清理无效的 MEF 组件缓存（位于 %LocalAppData%\Microsoft\VisualStudio\...\ComponentModelCache）
• 对非主流语言采用 Roslyn 分析器桥接方案