Windows平台开发指南

第一步：安装工具与依赖

安装 Visual Studio 2022 (MSVC 14.44.35211)

• 安装工作负载：“使用 C++ 的桌面开发”
• 勾选：
  • MSVC 14.44.35211
  • Windows 10/11 SDK
• 打开 VS Installer，选择 Desktop development with C++
• 勾选 MSVC、Windows 10/11 SDK
• 安装完成后，启动一次 VS 以初始化组件

安装 xmake

推荐使用 scoop 或 choco 安装。任选其一：

• scoop：

  scoop install xmake

• chocolatey：

  choco  install xmake

• 验证：

  xmake --version

第二步：获取源码进行编译运行

选择你自己的工作目录，例如 E:\TestFile：

cd E:\TestFile
git clone git@gitee.com:XmacsLabs/mogan.git
cd mogan

使用 xmake 配置与构建

xmake 项目配置

xmake config --yes -vD -m releasedbg --plat=windows --vs_runtime=MT

之前构建失败，先清理旧缓存

xmake f -c
xmake c -a

编译项目

xmake build stem

安装目标

xmake install stem

运行程序

xmake run stem

在VSCode下开发（可选）

如果用VSCode来开发，xmake可以生成compile_command.json文件。如果提供这份文件，VSCode的C++插件会根据这个文件来识别项目结构，提供正确的语义高亮等语义提示。

xmake project --kind=compile_commands ./.vscode

修改.vscode/c_cpp_properties.json文件才能使刚刚生成的compile_command.json文件生效。

{
    {
    "configurations": [
        {
            // other configs
            "compilerPath": "<your configuration>",
            "cppStandard": "gnu++17",
            "intelliSenseMode": "windows-gcc-x64",
            "compileCommands": ".vscode/compile_commands.json"
        }
    ],
}
}