在 VSCode 中预览火山 wsv 源码文件，提供表格化的代码可视化效果，与火山 IDE 中的显示效果一致。同时支持解决方案-多项目管理、F5 无缝编译调试、项目模块配置等完整开发工作流。
🌋 火山官方网站：www.voldp.com | 社区论坛：bbs.voldp.com
欢迎赞助本插件：
支付宝赞助：
微信赞助：
使用前：请先打开插件设置，将火山目录和平台设置一下。
功能特性
一、WSV 源码预览
将火山 .wsv 源码文件解析为结构化表格，包含包、类、成员变量、常量、方法等节点，与火山 IDE 中的显示效果一致。
| 功能 |
说明 |
| 表格化预览 |
解析 .wsv 源码，渲染为包/类/方法/变量/常量等结构化表格 |
| 三种预览模式 |
手动预览、自动预览、仅预览（可在设置中切换） |
| 快捷键预览 |
Ctrl+Shift+V 当前面板预览，Ctrl+K V 侧边预览 |
| 右键菜单预览 |
在编辑器或资源管理器中右键即可触发预览 |
| 编辑器标题栏按钮 |
点击标题栏预览图标触发预览 |
| 文件变化自动刷新 |
外部程序（如 AI 生成代码）修改 .wsv 文件后预览自动刷新 |
| 复制源码 |
一键复制原始源码到剪贴板 |
| 折叠/展开 |
支持节点折叠和展开，方便浏览大型文件 |
| 解析失败回退 |
源码解析失败时自动回退为原始文本显示 |
| UTF-8 编码 |
使用 UTF-8 编码读取文件 |
二、VPRJ 项目属性配置
点击 .vprj 文件即可直接打开属性配置窗口，无需通过右键菜单触发。
| 功能 |
说明 |
| 模块配置 |
扫描火山根目录下的系统模块（sys）和第三方模块（user），以列表形式多选配置 |
| 模块搜索 |
支持中文名称、全拼、首字母缩写搜索，按相关度排序 |
| 模块分类过滤 |
可按"全部 / 系统模块 / 第三方模块"过滤 |
| 模块详情 |
点击模块查看作者、版本、注释、依赖关系、包含文件等详情 |
| 依赖自动补齐 |
选中模块时自动递归解析其依赖模块，一并加入配置，支持循环依赖检测 |
| 全选/除基本模块外全不选 |
快捷操作按钮 |
| 视窗平台属性配置 |
可视化编辑应用名称、描述、图标、输出文件名、编译选项等项目属性 |
| 文件浏览按钮 |
支持选择图标(.ico)、输出文件名(.exe)、清单文件(.manifest/.xml)、文件夹、翻译词库(.txt) |
| 备份文件排除 |
自动识别并排除 ~vbak.vprj 备份文件，不会误操作 |
| 可拖拽分割条 |
模块列表与详情面板之间可拖拽调整宽度 |
| 扫描日志 |
显示模块扫描过程日志，便于排查问题 |
属性配置窗口：
模块配置窗口：
三、项目管理
支持火山解决方案（.vsln）下的多项目管理，提供活动项目机制用于 F5 编译调试。
| 功能 |
说明 |
| 设为活动项目 |
右键文件夹设为活动项目（自动验证含 .vprj 文件） |
| 切换活动项目 |
状态栏按钮点击弹出快速选择列表，展示所有项目并切换 |
| 状态栏显示 |
左下角状态栏实时显示当前活动项目名称 |
| 活动项目高亮 |
资源管理器中用星标(★)和醒目颜色高亮活动项目文件夹，主题自适应 |
| 项目自动扫描 |
自动扫描工作区中所有含 .vprj 文件夹（深度3层） |
| 解决方案识别 |
自动向上查找 .vsln 文件确定解决方案根目录 |
| 跨会话持久化 |
活动项目状态跨 VSCode 重启保留，自动恢复 |
| 多工作区隔离 |
不同解决方案之间状态独立，互不干扰 |
四、新建项目
提供可视化新建项目向导，从火山模板创建项目。
| 功能 |
说明 |
| 项目模板分类 |
按开发平台分类显示（PC平台-服务器/视窗，移动平台-安卓） |
| 模板详情 |
显示选中模板的名称和描述 |
| 项目配置 |
输入项目名称、选择存放位置 |
| 解决方案关联 |
添加到现有解决方案（.vsln）或创建新解决方案 |
vsln 右键菜单：
五、新建文件
在项目中快速创建火山 .wsv 源码文件，并自动添加到项目配置。
| 功能 |
说明 |
| 右键新建 |
在文件夹或 .vprj 文件上右键选择「火山：新建文件」，菜单位于其它火山菜单之前 |
| 项目定位 |
自动识别当前目录或向上查找 .vprj 项目文件；多个项目时弹出选择器 |
| 备份文件排除 |
自动排除 ~vbak.vprj 等火山备份项目文件，防止误操作 |
| 默认文件名 |
自动命名为「新建文件.wsv」，若已存在则递增为「新建文件1.wsv」等 |
| 自动填充模板 |
生成火山格式头、包名（火山.程序）和随机类名（类xxxxx） |
| 自动登记到项目 |
新文件以相对路径形式写入 .vprj 的 files 块，使用双反斜杠格式 |
| 自动打开渲染模式 |
创建完成后直接使用火山 WSV 渲染编辑器打开，无需手动切换预览模式 |
六、编译与调试
集成火山命令行编译器，支持 F5 无缝编译调试。
| 功能 |
说明 |
| F5 无缝调试 |
无需 launch.json，按 F5 自动编译活动项目（调试版）并运行 |
| 编译调试版 |
右键 .vprj 文件或文件夹，调用火山编译器编译调试版（/d） |
| 编译发布版 |
右键 .vprj 文件或文件夹，调用火山编译器编译发布版 |
| 生成原生代码 |
右键触发，仅生成 C++ 目标代码（/c），不编译为可执行文件 |
| 多平台支持 |
安卓、视窗、服务器及组合平台，自动选择对应编译器 |
| 编译终端 |
使用真实终端执行编译器，完整显示编译输出 |
| 编译完成检测 |
轮询输出目录检测生成的 exe/apk 文件，文件大小稳定即认为编译成功 |
| 编译成功后操作 |
F5 场景自动运行程序；菜单触发时提示"运行程序 / 打开所在文件夹" |
| 防重复编译 |
编译进行中再次触发时提示终止并重新开始 |
七、文件装饰
在资源管理器中为火山项目文件提供视觉标识。
| 功能 |
说明 |
| .vprj 文件徽标 |
.vprj 文件图标上显示模块数量徽标 |
| .vprj 悬浮提示 |
鼠标悬浮显示项目名、类型（安卓/视窗/服务器）、模块数摘要 |
| 活动项目标记 |
活动项目文件夹显示星标(★)和高亮颜色，悬浮提示"当前活动项目" |
八、火山根目录配置
| 功能 |
说明 |
| 可视化选择根目录 |
在设置页点击链接直接弹出文件夹选择对话框 |
| 路径校验 |
自动校验根目录是否存在，未配置时引导用户设置 |
安装
方式一：从 .vsix 文件安装
- 打开扩展面板 (
Ctrl+Shift+X)
- 点击右上角
... 菜单
- 选择「从 VSIX 安装」
- 选择
.vsix 文件
使用方法
火山右键菜单
在资源管理器中右键文件夹或文件，即可看到火山相关菜单项：
WSV 源码预览
- 打开任意
.wsv 文件
- 通过以下方式触发预览：
- 快捷键：
Ctrl+Shift+V（当前面板预览）或 Ctrl+K V（侧边预览）
- 命令面板：
Ctrl+Shift+P 输入「点击预览火山源码」
- 右键菜单：在编辑器或资源管理器中右键选择「点击预览火山源码」
- 编辑器标题栏：点击预览图标
项目属性配置
- 点击
.vprj 文件：直接打开属性配置窗口
- 右键文件夹：选择「火山: 配置项目模块」
vprj 右键菜单：
设为活动项目
- 右键文件夹：选择「火山: 设为活动项目」
- 状态栏切换：点击左下角状态栏按钮，从项目列表中选择
编译与调试
- F5 调试：直接按 F5，自动编译活动项目并运行
- 右键编译：右键
.vprj 文件或文件夹，选择「编译调试版 / 编译发布版 / 生成原生代码」
新建项目
- 右键空白区域 / 文件夹 / .vsln 文件：选择「火山: 新建项目」
新建文件
- 右键文件夹 /
.vprj 文件：选择「火山: 新建文件」，输入文件名后自动创建 .wsv 并添加到项目
- 子文件夹支持：在
src 等子文件夹上右键时，会自动向上查找所属项目
- 多项目选择：若目录中存在多个项目，会弹出选择器并显示项目名与完整路径
设置项
在 VSCode 设置中搜索「火山」即可找到所有配置项。
1. 预览模式 (volcanoWsv.previewMode)
选择 .wsv 文件的打开方式。
| 选项 |
说明 |
| 手动预览（默认） |
点击 .wsv 文件只打开文本编辑器，需要通过命令/按钮/快捷键触发预览 |
| 自动预览 |
点击 .wsv 文件打开文本编辑器的同时，自动在侧边显示预览 |
| 仅预览 |
点击 .wsv 文件直接打开预览界面，不显示文本编辑器 |
2. 火山根目录 (volcano.rootPath)
火山软件开发平台根目录路径（如 E:\voldev\voldp）。
- 在设置页可点击「浏览并选择文件夹」链接直接弹出文件夹选择对话框
- 未配置时，新建项目、模块配置、编译等功能会引导用户设置
3. 解决方案搜索排除模式 (volcanoWsv.excludePatterns)
搜索 .vsln 解决方案文件时排除的目录模式（glob 通配符）。
- 默认值：
["**/_int/**", "**/node_modules/**"]
- 示例：
**/_int/** — 排除所有 _int 目录**/node_modules/** — 排除 node_modules 目录**/.git/** — 排除 .git 目录
- 修改后需要重新打开「新建项目」窗口才能生效
F5 编译时使用的目标平台，决定调用哪个火山编译器。
| 选项 |
对应编译器 |
| 未设置（默认） |
按 F5 时会提示选择 |
| 安卓 |
voldev_ap.exe |
| 安卓+视窗 |
voldev_awp.exe |
| 安卓+视窗+服务器 |
voldev_awsp.exe |
| 服务器 |
voldev_sp.exe |
| 视窗 |
voldev_wp.exe |
| 服务器+视窗 |
voldev_wsp.exe |
快捷键
| 快捷键 |
功能 |
条件 |
Ctrl+Shift+V |
当前面板预览 WSV 源码 |
打开 .wsv 文件时 |
Ctrl+K V |
侧边面板预览 WSV 源码 |
打开 .wsv 文件时 |
F5 |
编译并调试活动项目 |
已设置活动项目和编译平台 |
命令列表
| 命令 |
说明 |
| 点击预览火山源码 |
预览当前 .wsv 文件 |
| 火山: 在侧边预览源码 |
在侧边面板预览 .wsv 文件 |
| 火山: 设为活动项目 |
将选中文件夹设为活动项目 |
| 火山: 切换活动项目 |
弹出列表切换活动项目 |
| 火山: 新建项目 |
打开新建项目向导 |
| 火山: 新建文件 |
创建 .wsv 文件并自动添加到项目 |
| 火山: 配置项目模块 |
打开模块配置窗口 |
| 火山: 编译当前项目为调试版 |
编译调试版（/d） |
| 火山: 编译当前项目为发布版 |
编译发布版 |
| 火山: 生成原生代码 |
仅生成 C++ 目标代码（/c） |
| 火山: 选择软件根目录 |
弹出对话框选择火山根目录 |
支持的平台
| 平台 |
说明 |
| Windows |
完整支持（火山编译器为 Windows 原生程序） |
| macOS |
支持 WSV 预览功能（编译功能依赖 Windows 火山编译器） |
| Linux |
支持 WSV 预览功能（编译功能依赖 Windows 火山编译器） |
支持的文件类型
| 扩展名 |
说明 |
打开方式 |
.wsv |
火山源码文件 |
文本编辑器 + 预览（根据预览模式） |
.vprj |
火山项目配置文件 |
属性配置窗口（自定义编辑器） |
.vsln |
火山解决方案文件 |
文本编辑器 |
.vgrp |
火山模块文件 |
模块配置中扫描识别 |
| |
