【SpreadJS 新版本特性揭秘】SpreadJS 专属 VS Code 设计器插件 \(Excel SpreadJS Editor\) 全面解析

一、 无缝整合的文件管理与编辑体验

该插件的核心目标是将 VS Code 原生的文件系统与 SpreadJS 设计器完美对接。

广泛的文件格式支持

安装插件后，VS Code 将具备直接使用 SpreadJS 设计器打开多种主流表格文件的能力。支持的格式包括：

• .sjs 、.ssjson 、.xlsx、 .xlsm、.xltm 、.csv

同时，插件为专属的 .sjs 和 .ssjson 格式注册了专用的文件图标，方便开发者在资源管理器中快速识别。

快捷的上下文菜单与命令面板

开发者可以通过以下两种主要方式唤起设计器：

• 资源管理器右键菜单：直接在文件树中右键点击支持的文件，选择新增的 “Open with SpreadJS” 选项即可在当前编辑器标签页中打开。

• VS Code 命令面板：按下 Ctrl+Shift+P 唤出命令面板，输入 SpreadJS: 即可看到创建各类空白工作簿（如 .sjs、.xlsx、.csv）的快捷命令

为编辑器量身定制的文件菜单 (File Menu)

由于 VS Code 本身是一个文件编辑器，它的核心数据是文件系统上的独立文件。因此，插件对原生设计器的文件菜单进行了深度定制：

• 移除了不适用于此场景的“新建 (New)”、“打开 (Open)”、“导入 (Import)”和“保存 (Save)”功能。

• 由于 VS Code 插件环境的限制（不支持 window.print API），移除了“打印 (Print)”功能。

• 保留了“导出 (Export)”功能（本质上相当于“另存为”），并将原有的“保存”合并至导出选项中的“SpreadJS File”分类下。

在文件修改后，插件会自动检测变更，VS Code 标签页会显示未保存状态，开发者直接使用 Ctrl+S 即可保存文件。如果在未保存时关闭标签页，VS Code 会弹出标准的数据防丢失提示。

二、 高度定制化的 UI 与国际化支持

为了保证与开发者现有工作环境的统一，插件提供了丰富的个性化配置项。

深入适配的主题系统

插件完全支持 VS Code 的深色 (Dark) 与浅色 (Light) 主题切换。当开发者更改 VS Code 的外观主题时，设计器插件会自动感知并切换到对应的视觉主题，提供毫无违和感的沉浸式体验。

Ribbon 菜单模式与快捷键调整

开发者可以自由切换顶部 Ribbon 菜单的显示模式（如经典模式 Classic Ribbon 或单行模式 Single Line Ribbon）。 需要注意的是，为了避免快捷键冲突，设计器原生的命令面板快捷键（Ctrl+P）已被调整为 Ctrl+Alt+P，以让位于 VS Code 原生的文件搜索功能。

多语言与区域文化 (Culture Support)

插件默认跟随 VS Code 的显示语言来加载对应的资源和文化配置。同时，开发者也可以通过 VS Code 的 settings.json 进行强制重写。

三、 通过 JSON 掌控底层配置

对于高阶开发者，插件允许通过 VS Code 的 settings.json 直接干预工作簿初始化和底层 IO 行为。

• 工作簿选项 (workbookOptions)：在创建全新工作簿时生效（例如开启动态数组或控制非法公式的校验）。

• IO 选项：在打开现有文件时应用特定的 openOptions 或 importOptions。

代码示例 (settings.json** 配置片段)：**

{
    "spreadjs": {
        "language": "zh", 
        "culture": "zh-cn",
        "ribbonMode": "classic",
        "workbookOptions": {
            "allowDynamicArray": true,
            "allowInvalidFormula": true
        },
        "openOptions": {
            // 此处可配置 GC.Spread.Sheets.OpenOptions
        },
        "importCsvOptions": {
            // 此处可配置 GC.Spread.Sheets.ImportCsvOptions
        }
    }
}

四、 企业级的数据安全与兼容性保障

密码保护支持

当开发者尝试打开被密码保护的 .xlsx 文件时，插件会弹出原生对话框要求输入密码。密码正确方可渲染界面，错误则会提示异常并自动安全关闭当前标签页，防止数据泄露。

严格的版本向下兼容策略

随着 SpreadJS v19 的发布，底层依赖包迎来了升级。为了保护开发者的存量资产，插件实施了严格的兼容性策略：

• 当用户打开旧版本（如 v17 或 v18）创建的文件时，插件会弹出兼容性警告通知。

• 强校验拦截：插件不允许直接使用 Ctrl+S 保存旧版本文件，因为这会隐式升级文件格式，导致仍在使用旧版 SpreadJS 的同事无法正常读取。开发者必须通过“另存为 (Save As)”来生成新版本文件，从而严格保护原始文件的格式一致性。

• 
  

授权使用说明

安装并启用该插件无需填写授权密钥

未购买商业授权的情况下，设计器界面右下角会自动显示试用版水印