Windows 安装
以下流程适用于本地开发、调试和 Windows 服务端构建。
前置环境
安装以下工具:
- 64 位 Windows;
- Visual Studio 2022/2026 或 Build Tools;需要固定 Visual Studio 2022 时使用旧版本下载页;
- 在 Visual Studio Installer 中启用“使用 C++ 的桌面开发”和 Windows SDK;
- Git for Windows;
- CMake 3.25 或更高版本;
- Ninja。
推荐从 Developer PowerShell for VS 运行安装脚本,使 MSVC、Windows SDK 和工具链环境变量完整可用。
执行安装
在仓库根目录运行:
powershell
# 默认构建 Release
.\install\install_windows.bat
# 构建 Debug
.\install\install_windows.bat Debug
# 明确构建 Release
.\install\install_windows.bat Release批处理会调用 install_windows.ps1。当前 PowerShell 参数如下:
| 参数 | 说明 |
|---|---|
| `-Configuration Debug | Release` |
-VcpkgRepository <url> | 首次克隆 vcpkg 使用的仓库地址 |
-VcpkgRef <ref> | 仅首次克隆时检出的 vcpkg revision |
-SkipBuild | 只完成 vcpkg/CMake 配置,不执行编译 |
需要使用这些命名参数时,直接调用 PowerShell 脚本:
powershell
.\install\install_windows.ps1 `
-Configuration Release `
-VcpkgRepository https://github.com/microsoft/vcpkg.gitWindows 使用以下 CMake 配置:
text
Preset: windows-ninja
Generator: Ninja Multi-Config
Build dir: kbe/src/out/build/windows-ninja-multi
Runtime dir: kbe/bin/server默认安装脚本使用 Ninja Multi-Config,适合日常增量编译和 CI。需要使用 Visual Studio 浏览、编译或调试 C++ 工程时,请继续阅读 生成 Visual Studio 工程。
Windows 常见前置问题
cl.exe找不到:没有从 Developer PowerShell 运行,或未安装 C++ 工作负载;ninja找不到:安装 Ninja 并加入PATH;- CMake 选择了错误架构:清理错误配置目录后,从 x64 Developer PowerShell 重新配置;
- vcpkg 下载失败:先解决网络、代理或仓库镜像,避免把不完整目录当作可用安装。
