来源: Makefile CMakePresets.json doc/c++/COMPILING.md commit d32b9cc880a8 build-config

WSL 开发¶

WSL 在 Windows host 上运行 Linux toolchain，适合 Linux 构建与测试，但不能证明原生 MSVC/MinGW packaging、Windows DLL discovery 或原生 Windows console/input 路径。

有意选择文件系统¶

Linux 构建放在 WSL Linux filesystem 通常比 /mnt/c 更快，权限也更可预测。记录 checkout 与 build directory 位于 Linux 还是 mounted Windows filesystem；case sensitivity、 executable bit、file watching 与 path translation 都可能改变故障形态。

构建路径¶

使用 Makefile 或 CMakePresets.json 的 Linux 契约，不使用 Windows preset：

cmake --list-presets
cmake --preset linux-x64
cmake --build --preset linux-x64

tiles、sound 或实际启动游戏还要分别说明 WSL version、graphics integration、display/audio environment、GPU/driver path 与 SDL 版本。headless curses test 通过不能验证这些层。

验证边界¶

报告 Windows version、WSL version/distribution、filesystem location、compiler、preset/ flag，以及 binary 是否只在 WSL 内测试。用 Git 验证 line ending/executable bit，但不要把平台生成文件或本地 mount path 加入仓库。

常见失败¶

mounted drive 元数据慢、Windows tool 意外位于 PATH 前、CRLF shell script、GUI/audio socket 不可用和 memory limit 需要不同修复。判断是 CCB 代码还是 WSL 集成前，应在原生 Linux CI lane 复现。