BAIZE AI RESOURCE

xlflow｜Excel VBA 开发支持 CLI 与 VS Code 插件

xlflow｜Excel VBA 开发支持 CLI 与 VS Code 插件

面向 Excel VBA 开发的 CLI 与 VS Code 插件，用于提取、版本管理、测试和回写工作簿代码。

获取资源
xlflow｜Excel VBA 开发支持 CLI 与 VS Code 插件

资源介绍

xlflow 是一个专为 Excel VBA 开发设计的命令行工具，最初旨在让 AI 代理能够自主开发 Excel VBA 宏。它能够从 .xlsm、.xlam、.xlsb 等 Excel 工作簿中提取 VBA 代码为独立的 .bas、.cls、.frm 文件，使代码可以纳入 Git 版本控制，编辑后再重新应用回工作簿。此外，xlflow 还支持从命令行直接运行 VBA 宏、执行测试、lint、格式化和静态分析，适合人类开发者与 AI 代理协同工作。项目还提供了 Visual Studio Code 扩展，将这些功能图形化，并集成了 Language Server Protocol（LSP）服务器，提供代码补全、诊断、符号分析等现代语言特性，提升开发体验。xlflow 主要面向需要在 Excel 中维护复杂 VBA 项目的开发者，尤其是希望将 VBA 开发流程现代化、引入版本控制与自动化测试的团队。

插件能力

VBA 代码提取与回写

支持从 Excel 工作簿（.xlsm、.xlam、.xlsb）中提取 VBA 模块为文本文件，编辑后可重新推送回工作簿，实现代码的文本化管理。

CLI 驱动的开发流程

提供命令行工具，支持运行宏、执行测试、lint、格式化、静态分析等操作，便于集成到自动化流程或 AI 代理工作流中。

VS Code 插件与 LSP 支持

提供 VS Code 扩展，将核心功能图形化，并通过 LSP 提供代码补全、实时诊断、符号分析、语义高亮等现代编辑体验。

Git 版本控制集成

通过将 VBA 代码转换为文本文件，使 Excel 宏能够纳入 Git 版本控制，支持分支、合并、历史追溯等标准开发实践。

测试与静态分析

内置测试框架和基于 AST 的 linter、格式化工具，支持对 VBA 代码进行自动化测试和静态质量检查。

资源配置

插件类型

IDE插件

支持平台

VS CodeExcel

插件格式

Source Code

安装方式

源码安装

使用要求 / 配置要求

安装 VS Code 扩展后，需在设置中配置 xlflow.path 指向 xlflow CLI 可执行文件。

安装与配置

  1. 1. 优先通过官方 WinGet、Scoop 或 GitHub Releases 安装 xlflow；若使用官方远程 PowerShell 脚本，应先下载审查再执行，并核对发布页 SHA256 与 GitHub attestation。

  2. 2. 在 Windows 安装 Microsoft Excel，并启用“信任对 VBA 项目对象模型的访问”；工作簿命令依赖 Excel COM 与随 Windows 包提供的 .NET bridge。

  3. 3. 用 xlflow new 创建 .xlsm/.xlam/.xlsb 项目，或用 xlflow init 从现有工作簿初始化并提取源码。

  4. 4. 使用 pull 导出、编辑 .bas/.cls/.frm 文件，再用 push 回写；先备份工作簿并在受控环境验证。

  5. 5. 使用 lint、fmt、analyze、diff、test 和 run 完成检查；在 WSL 中执行工作簿命令时需同时安装 Windows 端并把项目放在 Windows 可访问路径。

使用案例

VBA 源码版本控制

使用场景将现有 .xlsm、.xlam 或 .xlsb 工作簿纳入 Git

运行 xlflow init 自动复制工作簿并把 VBA 模块提取到 src/，后续通过 pull 与 push 同步文本源码。

自动化质量检查

使用场景在提交前检查 VBA 代码质量

使用 xlflow lint、fmt、analyze 与 test 检查格式、常见风险模式和测试结果，并读取结构化 JSON 输出。

AI Agent 协作开发

使用场景让编码 Agent 在不操作 Excel UI 的情况下修改 VBA

安装 xlflow Skill，让 Agent 基于稳定 CLI 与 JSON 契约编辑源码，再由人工在 Windows Excel 环境验证回写与执行。

WSL 与 Windows 协同

使用场景在 WSL 编辑、在 Windows Excel 执行工作簿命令

Windows 与 WSL 两侧均安装 xlflow，把项目置于 /mnt/c 等共享路径，由 Windows xlflow 与 Excel COM 完成工作簿操作。

包含内容

LICENSE-MIT-1.txt
LICENSE-MIT-10.txt
LICENSE-MIT-11.txt
LICENSE-MIT-12.txt
LICENSE-MIT-13.txt
LICENSE-MIT-14.txt
LICENSE-MIT-15.txt
LICENSE-MIT-16.txt
LICENSE-MIT-17.txt
LICENSE-MIT-18.txt
LICENSE-MIT-2.txt
LICENSE-MIT-3.txt
LICENSE-MIT-4.txt
LICENSE-MIT-5.txt
LICENSE-MIT-6.txt
LICENSE-MIT-7.txt
LICENSE-MIT-8.txt
LICENSE-MIT-9.txt
LICENSE-MIT.txt
README-中文安装说明.md
release-0-xlflow_windows_x86_64.zip
SHA256.txt

常见问题

xlflow 支持哪些操作系统？
提供 Windows 与 Linux x64 构建；Linux/WSL 可执行源码类命令，但需要打开、回写、运行或测试工作簿时，仍须由 Windows 端 Microsoft Excel、COM 和 .NET bridge 完成。
如何更安全地安装？
优先使用官方 WinGet、Scoop 或 GitHub Releases；下载发布包后核对 checksums 文件与 GitHub attestation。官方快速脚本会下载并执行外部代码，建议先保存并审查脚本。
使用工作簿命令需要什么？
需要 Windows、Microsoft Excel、Excel COM，以及启用“信任对 VBA 项目对象模型的访问”；安全策略还可能拦截未做 Authenticode 签名的 bridge 可执行文件。
如何纳入 Git 版本控制？
xlflow 将标准模块、类模块、UserForm 和文档模块导出为文本源码，可用 pull/push 与工作簿同步，再按普通 Git 流程审查差异。
是否支持自动化测试与分析？
支持 test、lint、fmt、analyze 和 diff 等 CLI 命令；其中工作簿测试/运行需要真实 Windows Excel 环境，不能把纯源码检查等同于完整端到端验证。