【建议】开发WPS官方VS Code插件
Lv.2潜力创作者
一、背景
当前 Visual Studio Code 生态中，办公文档处理由第三方开源项目 vscode-office 长期占据。该插件覆盖 PDF、Excel、Word、Markdown 等 10 余种格式，GitHub 积累 1,380 颗 Star，Marketplace 安装量约 117 万。然而该项目已于 2026 年归档停维，224 个未关闭 Issue 不再处理，底层渲染库不再更新。
在 VBA/宏开发垂直领域，XVBA - Live Server VBA 插件验证了"在 IDE 中处理办公自动化代码"是真实且持续的需求。
微软于 2024 年推出、2026 年 5 月宣布退役的 Office Add-ins Development Kit 再次印证了 VS Code 办公开发工具赛道的复杂性。
WPS 拥有成熟的 WebOffice SDK 和开放平台 API（https://solution.wps.cn），覆盖文字、表格、演示和 PDF 四大主流文档格式。WPS JS 插件运行于独立的 JavaScript 引擎，原生支持 LSP（语言服务协议）和 DAP（调试适配器协议），在架构层面具备提供现代开发体验的技术基础。当前 vscode-office 停维所留下的功能真空，以及 VBA 开发者在 VS Code 中未被满足的深度需求，共同构成了 WPS 官方进入 VS Code 生态的战略窗口。
二、WPS WebOffice SDK 技术基础
WPS WebOffice SDK（https://solution.wps.cn/docs/client/basic/custom-function.html）是构建 VS Code 插件的技术核心，提供了一套基于 Web 技术的文档渲染和编辑能力。其关键技术特性包括：
同源渲染引擎。 渲染内核与 WPS 桌面端共享同一套排版引擎，在中文排版（首行缩进、中文字体回退、标点挤压、行距控制）和复杂文档兼容性（修订模式、多栏排版、嵌入对象、交叉引用）上与桌面端保持一致。这与 vscode-office 使用的社区轻量库形成根本性差异——后者本质上是"尝试还原"Office 格式，而 WebOffice SDK 是"直接使用"经过数十年打磨的商用级排版引擎。
编辑能力内建。 SDK 不仅支持高保真预览，还提供完整的编辑能力：文字编辑、表格公式计算、幻灯片布局调整、批注和修订等。
离线部署支持。 SDK 支持私有化部署，渲染引擎可嵌入本地环境运行，对企业内网环境和注重数据安全的场景尤为重要。
格式覆盖全面。 支持读取和编辑 .doc/.docx/.xls/.xlsx/.ppt/.pptx/.pdf 等主流格式，以及 WPS 专有格式（.wps/.et/.dps），且对新版 Office 格式特性的兼容性由 WPS 团队持续保障。
三、目标用户画像
用户类型 | 核心需求 | 典型场景 |
全栈开发者 | 在 IDE 内预览和编辑办公文档 | 阅读技术文档（.docx）、检查数据报表（.xlsx） |
技术写作者 | Markdown 与 Word 双向流转 | API 文档、技术规范的撰写与排版 |
数据分析师 | 表格公式计算与数据透视 | ETL 中间产物检查、数据整理与验证 |
WPS 插件开发者 | 完整的开发调试工具链 | 使用 WPS Open API 构建办公自动化插件 |
VBA/自动化工程师 | 现代 IDE 替代 VBE | 从 Excel 提取宏代码到 VS Code，获得调试能力 |
项目管理者 | 快速预览文档和报告 | 查看项目周报、需求文档、会议纪要 |
全栈开发者和技术写作者是最大基盘——vscode-office 的 117 万安装量已验证了文档预览需求的广度。WPS 插件开发者和 VBA/自动化工程师是差异化目标——XVBA 证明了垂直开发需求的深度，但 COM 架构的根本限制使其无法走远，WPS JS 插件引擎在架构层面具备替代潜力。
四、功能架构设计
按四层架构设计，由基础到高级逐层叠加。
4.1 第一层：文档预览与查看
通过 VS Code WebviewPanel 嵌入 WPS WebOffice SDK，实现四大格式的高保真预览。该层为 MVP 核心。
功能 | 说明 |
WebOffice SDK 内嵌预览 | 支持 .docx/.xlsx/.pptx/.pdf 四大格式的高保真渲染 |
侧边栏文档图标识别 | 在资源管理器中为办公文件提供专属图标和快速预览入口 |
双栏同步滚动 | 左侧代码、右侧文档同步滚动，服务"代码写完写文档"的工作流 |
文档大纲导航 | 解析文档标题层级，提供 TOC 快速跳转，长文档快速定位 |
对标 vscode-office 的升级点：vscode-office 存在 Excel 保存格式丢失、CSV 不支持 GBK 编码、PDF 偶发渲染失败等问题。WPS WebOffice SDK 基于同源渲染引擎，在格式保真度、中文排版支持和复杂文档兼容性上具有系统性优势。双栏同步滚动进一步提升了"代码 + 文档"并行的开发体验。
4.2 第二层：文档编辑与创建
功能 | 说明 |
轻量编辑并保存 | 在 Webview 内修改文档内容并保存回本地文件，支持撤销/重做 |
模板快速创建 | 从命令面板调用 WPS 模板库，新建周报、报告、简历等标准文档 |
Markdown 转 Word | 将 .md 一键导出为 .docx，自动应用中文排版规范（字体、缩进、页眉页脚） |
代码片段嵌入 | 在文档中插入带语法高亮的代码块，复用 VS Code TextMate 语法主题 |
LaTeX 公式渲染 | 支持 LaTeX 公式输入和渲染，面向技术文档和学术论文场景 |
Markdown 转 Word 是该层的高价值功能。当前开发者在 VS Code 中使用 Markdown 编写技术文档后，通常需要手动复制到 Word 中重新排版。实现一键导出并自动应用中文字体、首行缩进、页眉页脚等排版规范，将显著提升技术写作效率。代码片段嵌入功能利用 VS Code 原生的 TextMate 语法高亮引擎，确保代码在导出后仍保持与编辑器一致的视觉风格。
4.3 第三层：数据与表格能力
功能 | 说明 |
CSV/TSV 智能识别 | 自动检测文件编码（含 GBK）和分隔符（逗号、制表符、分号），以表格形式打开 |
表格公式栏 | 在编辑区上方显示/编辑当前单元格公式，借鉴 Excel fx 栏交互模式 |
数据透视预览 | 对 .xlsx 文件提供轻量级数据透视和筛选，无需打开完整 Excel |
图表内嵌预览 | 渲染 .xlsx 中的图表对象（柱状图、折线图、饼图等），保留原始样式 |
数据库结果导出 | 配合 VS Code 数据库插件，将查询结果一键导出为格式化的 .xlsx 表格 |
CSV 智能识别直接解决了 vscode-office 用户长期反馈的 GBK 编码乱码问题。数据库结果导出功能打通了"SQL 查询 → 数据预览 → 表格导出"的链路，服务于数据驱动开发场景。
4.4 第四层：开发工具链集成
该层是差异化核心，服务 WPS 开发者生态，同时回应 XVBA 已验证的 VBA 开发需求。
功能 | 说明 |
JS 插件开发脚手架 | 一键创建项目模板，内置 TypeScript 类型定义、调试配置和热重载脚本 |
本地调试通道 | 在 VS Code 内断点调试 WPS JS 插件代码，支持变量监视和调用栈跟踪 |
Open API 智能补全 | 提供完整的 IntelliSense 补全、悬浮文档和代码片段，覆盖全部 WPS API |
VBA 至 JS 迁移助手 | 辅助将现有 VBA 宏转换为 WPS JS 插件代码，降低迁移成本 |
操作录制与转换 | 录制 WPS 桌面端操作，自动转换为 JS 插件代码，快速生成自动化脚本 |
插件发布向导 | 直接从 VS Code 打包、上传至 WPS 开放平台，可视化配置插件元信息 |
对标 XVBA 的战略升级：XVBA 受限于 VBA 宿主架构，存在三个根本限制——VBA 运行于 Excel 进程内，不暴露 DAP 接口，无法断点调试；VBA 对象模型不提供类型声明，无法实现精确 IntelliSense；VBA 代码与 .xlsm/.xlsb 强绑定，无法纳入 Git 版本控制。WPS JS 插件运行于独立引擎，原生支持 LSP 和 DAP 协议，代码以独立 .js/.ts 文件存储，可在架构层面提供完整的现代开发体验。操作录制与转换功能对标 Excel 宏录制器，但将录制结果输出为可版本控制的 JS 代码。
五、AI 能力集成
WPS 灵犀的 AI 能力应成为插件的差异化亮点：
功能 | 说明 |
文档智能摘要 | 选中文件生成结构化摘要，显示在侧边栏，快速了解文档核心内容 |
AI 辅助写作 | 在文档编辑时提供续写、润色、翻译等能力，基于 WPS 灵犀中文优化模型 |
自然语言生成公式 | 输入描述自动生成对应 Excel 公式，降低公式学习门槛 |
表格智能分析 | 选中表格区域，AI 自动生成透视表建议或可视化图表 |
注释转文档 | 提取代码注释块，自动生成 .docx 格式 API 文档，保持与代码同步 |
借助 WPS 灵犀在中文场景下的模型优化优势，自然语言生成公式和表格智能分析有望在中文用户群体中提供更精准的能力。注释转文档功能打通了"代码 → 文档"的自动化链路，对于维护 API 文档的开发团队尤其具有实用价值。
六、协作与云文档
功能 | 说明 |
WPS 账号绑定与云文档浏览 | 在 VS Code 中浏览和打开 WPS 云端文档，无需切换到浏览器或 WPS 客户端 |
实时多人协作编辑 | 基于 WebOffice 协同能力参与多人编辑，查看协作者光标位置 |
一键生成分享链接 | 右键菜单生成 WPS 云文档分享链接，支持权限和有效期设置 |
云文档版本历史浏览 | 在 VS Code 中查看和管理云文档版本，支持版本对比和回滚 |
云文档浏览功能打通了本地开发环境与 WPS 云端的通道，实现"代码 + 文档"的一站式工作流。
七、关键成功因素
启动性能。 VS Code 用户对插件性能极为敏感。建议采用懒加载策略：预览功能仅在首次打开文档时才初始化 WebView，编辑和 AI 功能按需加载，WebOffice SDK 异步初始化不阻塞编辑器启动。
离线优先。 核心预览和编辑功能应支持完全离线使用。云文档同步和 AI 能力作为在线增强层，离线时自动降级为本地模式。
开放 Extension API。 插件应暴露 Extension API，允许第三方插件调用 WPS 能力（如从数据库插件导出查询结果到 WPS 表格、从 Git 插件生成变更报告等），形成集成网络效应。
TypeScript 优先。 WPS Open API 的所有接口应同步提供 .d.ts 声明文件，既服务 WPS 插件开发者，也提升 VS Code 的 IntelliSense 体验。
精准切入停维空白。 首版应覆盖 vscode-office 全部支持的格式，重点修复 Excel 格式丢失、CSV 编码问题、PDF 渲染异常等长期痛点，以官方继任者姿态快速建立用户信任。首版发布时可提供一键从 vscode-office 迁移的配置导入功能，降低切换成本。
八、延伸阅读
WPS 开放平台：https://solution.wps.cn
WPS WebOffice SDK 文档：https://solution.wps.cn/docs/client/basic/custom-function.html
WPS社区反馈员