LingBuilder 文档中心

Appearance

安装与启动 ​

[🕒 预计 15 分钟；如需安装 C++ 构建环境约 30–60 分钟] | 难度：入门 | 适用于：Windows 10/11

安装流程导览

1. 系统要求 ​

安装 LingBuilder 前，请确认本机满足以下最低配置：

项目最低要求推荐配置
操作系统Windows 10 1809 (64 位)Windows 11 22H2 (64 位)
处理器双核 2.0 GHz四核 3.0 GHz 及以上
内存4 GB8 GB 及以上
磁盘空间2 GB 可用空间SSD，预留 10 GB（含 C++ 构建环境）
运行库Microsoft Visual C++ Redistributable 2015-2022（运行 LingBuilder 本身）最新版
C++ 构建环境Visual Studio Build Tools 2022（含 MSVC 与 Windows SDK），编译运行项目时必需最新版 Build Tools，随附 CMake

TIP

如果系统未安装 Microsoft Visual C++ Redistributable，安装向导会自动检测并提示下载，请按照提示完成后再继续安装 LingBuilder。

上表中的「运行库」只保证 LingBuilder 本身能启动；要在 IDE 中把中文项目编译并运行为本机 exe，还需要第 5 节的 C++ 构建环境（MSVC + Windows SDK）。全新系统默认没有该环境，请在首次点击「运行」前完成安装。

2. 下载安装包 ​

  1. 打开浏览器，访问 LingBuilder 官网首页。
  2. 在页面顶部导航栏点击 下载。
  3. 根据系统架构选择对应的安装包：
    • x64 版本：适用于绝大多数 64 位 Windows 系统。
    • Win32 版本：适用于 32 位 Windows 系统。
  4. 将安装包保存到本地任意位置（建议保存到 下载 文件夹）。

WARNING

请务必从官网或官方发布的下载链接获取安装包，切勿从第三方网站下载，以免造成安全风险或损坏的安装包。

3. 运行安装向导 ​

  1. 双击下载好的安装包文件。
  2. 如果系统弹出 用户账户控制 (UAC) 窗口，点击 是 允许安装程序运行。
  3. 选择界面语言（默认 简体中文），点击 确定。
  4. 阅读 许可协议，勾选 我接受许可协议中的条款，点击 下一步。
  5. 选择安装路径：
    • 默认路径为 C:\Program Files\LingBuilder。
    • 如需自定义路径，点击 浏览 选择目标文件夹。
  6. 选择是否创建 桌面快捷方式（建议勾选）。
  7. 点击 安装，等待进度条完成。
  8. 安装完成后，点击 完成 退出向导。

4. 首次启动向导 ​

首次启动 LingBuilder 时会进入 首次启动向导，引导用户完成基础配置：

  1. 选择 界面主题：
    • 深色主题（默认）
    • 浅色主题
  2. 设置 工作区目录：选择用于存放项目的文件夹。
  3. 选择 默认语言（默认跟随系统）。
  4. 等待 模块加载 完成（首次加载可能需要 30 秒至 1 分钟）。
  5. 点击 进入工作台，即完成首次配置。

首次启动向导

5. 安装 C++ 构建环境（编译运行必需） ​

LingBuilder 采用本地确定性编译：中文源码会被翻译为真实 C++ 代码，并使用微软工具链编译为本机 exe。因此除了安装 LingBuilder 本身，电脑还需要以下构建组件：

组件作用是否必需
MSVC（x86/x64 C++ 工具集）编译生成的 C++ 代码必需，默认 Win32 构建链的核心
Windows SDK提供窗口、控件等 Windows 头文件与库（含 rc.exe 资源编译器）必需
CMakeCMake 类型项目的构建支持可选
WebView2 Runtime需要 WebView2 的原生预览功能可选，Win10/11 一般已内置

g++ / clang++ 虽然也能被识别，但 LingBuilder 默认 Win32 构建以及依赖 Visual Studio .lib 导入库的模块必须使用 MSVC。

方式一：在 IDE 内一键安装（推荐） ​

  1. 启动 LingBuilder，按 Ctrl+Shift+P 打开命令面板。
  2. 执行 工具：打开环境修复中心。
  3. 点击 一键安装核心构建环境，LingBuilder 会自动从微软官方下载并运行 Visual Studio Build Tools 安装器（已自动勾选 MSVC、Windows SDK 与 CMake）。
  4. 按系统提示授权 UAC，等待安装完成后，环境修复中心会自动重新检测。

方式二：手动安装 ​

  1. 访问 Visual Studio 下载页，在「生成工具」区域下载 Visual Studio Build Tools 2022。
  2. 运行安装器，勾选 使用 C++ 的桌面开发 工作负载（默认已包含 MSVC 与 Windows SDK）。
  3. 点击 安装，等待完成（约需 6–8 GB 磁盘空间，耗时视网络而定）。
  4. 重启 LingBuilder，再次执行 工具：打开环境修复中心 确认检测通过。

NOTE

安装完成后无需配置任何环境变量，LingBuilder 会通过 vswhere 自动定位 MSVC 与 Windows SDK。

6. 验证安装是否成功 ​

安装并完成首次启动后，可以通过以下方式确认 LingBuilder 正常工作：

  1. 在工作台顶部菜单选择 文件 > 新建项目。
  2. 在弹出的对话框中选择 空白窗口项目，输入项目名称，点击 创建。
  3. 在主工具栏点击 运行（绿色 ▶ 按钮）。
  4. 如果程序窗口正常弹出且无报错，说明安装成功。

TIP

如果点击 运行 时提示未检测到 MSVC / C++ 编译环境，说明第 5 节的构建环境尚未装好，按提示打开 环境修复中心 完成安装后重试。

7. 常见安装问题 ​

7.1 运行项目时提示未检测到 MSVC / C++ 编译环境 ​

LingBuilder 本身能正常启动，但点击 运行 时提示「未检测到 MSVC」「资源文件编译不可用」等，说明本机缺少第 5 节的 C++ 构建环境。

  1. 按 Ctrl+Shift+P 打开命令面板，执行 工具：打开环境修复中心。
  2. 查看检测列表：MSVC 与 Windows SDK 必须为可用状态。
  3. 点击 一键安装核心构建环境 安装 Visual Studio Build Tools，完成后重新检测并再次运行项目。

7.2 运行时提示缺少 DLL ​

如果启动时提示缺少 VCRUNTIME140.dll 等文件，说明系统缺少 Visual C++ 运行库。

  1. 打开官网 下载 页面，在 运行库 区域下载并安装 Microsoft Visual C++ Redistributable 2015-2022。
  2. 安装完成后重启 LingBuilder。

7.3 杀毒软件拦截 ​

  • LingBuilder 为本地编译型开发工具，部分杀毒软件可能将首次编译产生的临时文件误报为风险程序。
  • 请将 LingBuilder 安装目录加入杀毒软件的白名单，或暂时关闭实时防护后重试。

7.4 安装后无法启动 ​

  • 检查系统是否满足最低配置要求。
  • 尝试右键 LingBuilder 快捷方式，选择 以管理员身份运行。
  • 若仍无法启动，请查看安装目录下的日志文件，或联系技术支持。

下一步 ​