LingBuilder 文档中心

Appearance

安装与管理模块 ​

[🕒 预计 15 分钟] | 难度：入门

模块的安装与管理入口位于左侧边栏底部的 模块 组（模块检查器面板），所有操作都在这里完成。

1. 从市场安装模块 ​

  1. 在侧边栏 模块 组中打开模块检查器，切换到 模块市场 区域。
  2. 按分类浏览或搜索目标模块。
  3. 点击模块卡片上的 预览安装，确认模块信息与依赖后等待下载完成。
  4. 状态变为 已安装 即表示模块可用。

2. 手动导入模块 ​

部分模块以 .lbmod 文件形式离线分发，可通过手动导入安装：

  1. 在侧边栏 模块 组中打开模块生态面板，展开 安装 .lbmod 区域。
  2. 把 .lbmod 文件拖入拖放区，或在路径框填写路径：支持 .lingbuilder/module-packages 下的工作区相对路径（例如 .lingbuilder/module-packages/demo.lbmod）；桌面版也支持本机绝对路径（例如 D:/Downloads/demo.lbmod），预览时会先校验文件并自动复制进工作区再走同一预览流程。网页版仅支持相对路径。
  3. 点击 预览安装。通过后状态行提示「模块包预览通过，等待确认安装。」，并弹出 模块安装预览：模块名与 ID、版本、文件数与大小、SHA256、是否替换现有版本，以及安全检查结论（通过时显示「检查通过，可以安装。」）。
  4. 需要当前项目直接使用该模块时保持勾选 安装完成后加入当前项目，然后点击 确认安装。预览未通过时该按钮不可用，请按安全检查列出的诊断处理。

NOTE

.lbmod 本质是 zip 包，根目录必须包含 v2 格式的 lingbuilder.module.json。导入失败时请确认文件未被损坏、清单符合 v2 规范，且平台目标包含当前系统架构。旧版 v1 模块包需先用模块迁移工具重新打包。

3. 管理已安装模块 ​

在侧边栏 模块 组的 本地模块 列表中（每行显示为 模块 ID · 版本 · 能力 N 项）可以：

  • 查看模块详情：点击模块行的 接口 打开「模块公开信息」，按 类型/类、命令接口、设计器控件、代码片段、C++ 依赖、文档 分类查看随包内容。
  • 启用 / 禁用模块：禁用后模块功能不会参与补全与构建。
  • 卸载模块：从环境中移除模块。
  • 更新模块：检测到市场有更新版本时升级。

4. 在项目中使用模块 ​

模块安装后，需要确保当前项目启用了该模块：

  1. 在 解决方案资源管理器 的项目节点下展开 模块 组。
  2. 点击 配置项目所使用模块，勾选目标模块。
  3. 项目启用的模块会保存到 .lingbuilder/project-modules.json，编辑器补全与构建都会随之生效。
  4. 按 F5 编译并热运行验证，模块运行时依赖会自动复制到构建目录。

下一步 ​