VS Code的《潜行者2》CFG编辑器扩展

STALKER 2 模组开发的必备 VS Code 扩展。

此扩展为 .cfg 文件提供全面的语言支持，将 VS Code 转变为强大且智能的 Stalker 2 配置文件编辑器。它超越了简单的语法高亮，提供了强大的错误检查、智能格式化和代码导航功能，让模组制作更快、更简单、更可靠。

基于一个稳健的、基于堆栈的解析器构建，此工具能正确理解代码结构，即使面对复杂的嵌套和不一致的空格。

主要功能

该扩展旨在提供原生语言支持般的体验，具备专业 IDE 应有的功能。

智能验证与诊断

• 实时错误检查： 立刻发现语法错误，从缺失的 struct.end 块到格式错误的属性。
• 智能拼写检测： 捕捉如 struct.begin 等关键字的常见拼写错误，并建议正确的替代项。
• 样式与一致性检查器： 针对不正确的空格、重复的键名以及无效的块或属性名提供警告，帮助您维护整洁的代码。
• 浮动值检测： 警告您那些未被赋值的字符串或数字字面量，这些内容会被游戏引擎忽略。

强大的格式化

• 保存时格式化： 每次保存时自动格式化整个文档，使其保持整洁、一致且易于阅读。
• 空格规范化： 通过将所有缩进转换为统一格式，解决“制表符 vs 空格”问题，消除一个常见的解析错误来源。
• 安全保障： 格式化程序在检测到严重语法错误时会自动禁用，防止文件损坏。

增强的 IDE 体验

• 代码折叠： 轻松折叠和展开 struct.begin/struct.end 块，聚焦于您正在处理的代码。
• 文档大纲： 资源管理器面板提供完整的文档符号树，让您能快速导航至任何块，无论嵌套多深。
• 语法高亮： 专用语法文件为关键字、类型、属性和值提供清晰准确的色彩编码。

工作原理

此扩展的强大之处在于其稳健的解析器，它能实时构建代码的抽象语法树 (AST)。

1. 词法分析： 代码首先被分解为一系列令牌（关键字、名称、值）。
2. 基于堆栈的解析： 基于堆栈的算法读取令牌，构建 struct 块的层级树。此方法不受混合制表符和空格的影响。
3. 验证与格式化： 扩展程序随后遍历正确的 AST，以识别错误、发现样式不一致并计算格式化编辑。

安装

从市场安装（推荐）

1. 在 VS Code 中打开扩展视图（Ctrl+Shift+X）。
2. 搜索 STALKER 2 CFG Struct Validator。
3. 点击安装。

从 VSIX 文件安装

1. 打开命令面板（Ctrl+Shift+P）。
2. 运行 Extensions: Install from VSIX...。
3. 选择 .vsix 文件。