(1)立项背景与目标
企业内部大量 Excel/Word/PowerPoint 工具是用 VBA 写的,通常以 .xlsm/.docm 形式在部门之间流转。这类文件有两个长期痛点:一是 VBA 工程常被密码保护或标记为"查看时锁定",接手的人根本改不了;二是改完之后要在多个文件之间同步,手动复制粘贴极易出错,且无法做版本管理。项目目标是做一个 VS Code 扩展,把 Office 文件里的 VBA 工程当成正常的代码工程来处理:能提取、能浏览、能批量修改、能编译回写。
(2)软件功能与核心功能模块
① 工程提取:用 olevba 解析 Office 文件,还原出模块、类模块、窗体与引用关系。
② 工程视图:在 VS Code 侧边栏以项目树展示模块结构,点击即可打开对应模块编辑。
③ 源码还原:把 VBA 工程中的文本与二进制部分还原成可编辑源码,保留原有模块名与声明顺序。
④ 编译回写:修改后按原结构编译回 .xlsm/.docm,保持宿主文件的其他部分不变。
⑤ 批量与并发:支持一次选择多个文件处理,内置并发编译与文件锁避让。
⑥ 环境面板:显示当前 Office 版本、位数、可用编译器与依赖状态。
(3)业务流程与功能路径
打开一个 Office 文件 → 扩展解析出 VBA 工程 → 侧边栏展示模块树 → 打开模块编辑源码 → 点编译 → 回写生成新文件 → 在 Office 中打开验证宏可运行。
(1)整体架构和设计思路
分三层。解析层用 olevba 读取 OLE 复合文档,把 VBA 工程流拆出来;中间层是 TypeScript 写的工程模型,负责模块解析、编辑缓冲、依赖检查与编译编排;执行层调用 Office 自带的 VBA 编译器(通过 COM)完成编译,再把结果按原始流结构写回。命令与界面通过 VS Code 扩展 API 注册,侧边栏用 TreeDataProvider 实现,右键菜单与命令面板共用同一套命令定义。
(2)我负责的模块和结果
独立完成全部实现,src 目录 14 个文件、4,140 行 TypeScript。功能覆盖 Excel、Word、PowerPoint 三个宿主,支持批量与并发编译;编译产物与原文件结构一致,可被 Office 正常打开、宏可正常运行。
(3)遇到的难点、坑与解决方案
难点一:VBA 工程不是纯文本。它存在 OLE 复合文档的特定流里,且经过 MS-OVBA 压缩算法处理,直接按字符串处理会破坏结构。解决方案是先做完整的流级解析,再对压缩数据做解压还原,编辑完成后按同样的算法压缩回去,全程用二进制而非文本读写。
难点二:并发编译互相踩文件。多个文件同时编译时会争用 Office COM 实例与临时目录,表现为随机失败。解决方案是引入编译队列限制并发度,每个任务使用独立临时目录,并对源文件加共享锁避免被占用。
难点三:COM 资源不释放。编译结束后 Word/Excel 进程残留,反复调用会累积僵尸进程直至系统卡顿。解决方案是用 Marshal.ReleaseComObject 逐层释放对象,在 finally 中强制退出应用实例,并配合进程级超时兜底。