Skip to content

Windows 安装

以下流程适用于本地开发、调试和 Windows 服务端构建。

前置环境

安装以下工具:

推荐从 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 DebugRelease`
-VcpkgRepository <url>首次克隆 vcpkg 使用的仓库地址
-VcpkgRef <ref>仅首次克隆时检出的 vcpkg revision
-SkipBuild只完成 vcpkg/CMake 配置,不执行编译

需要使用这些命名参数时,直接调用 PowerShell 脚本:

powershell
.\install\install_windows.ps1 `
    -Configuration Release `
    -VcpkgRepository https://github.com/microsoft/vcpkg.git

Windows 使用以下 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 下载失败:先解决网络、代理或仓库镜像,避免把不完整目录当作可用安装。