教程01 - Windows 环境初始配置

📖 本节导读

🎯 学习目标

学完本节后，你将掌握如何在 Windows 平台上搭建 Kohi 引擎的开发环境，理解项目的基本结构，并成功编译运行第一个测试程序。

⏱️ 预计时间：20 分钟 💪 难度等级：⭐☆☆☆☆（入门级） 🏷️ 关键词：环境搭建 DLL开发 VS Code配置 Clang编译

📋 前置知识

学习本节内容前，你需要了解：

💡 学习建议 如果你还不熟悉这些概念，建议先学习 C 语言基础和命令行操作。不过即使是初学者，跟着本教程一步步操作也能成功完成配置。

🎯 什么是项目初始配置？

📌 基本概念

项目初始配置是指为一个软件项目建立基础开发环境的过程。对于 Kohi 游戏引擎项目来说，这包括：

graph LR
    A[🛠️ 开发工具配置] --> B[📦 构建系统]
    B --> C[📁 项目结构]
    C --> D[💻 基础代码]
    style A fill:#e1f5ff
    style B fill:#fff3e0
    style C fill:#f3e5f5
    style D fill:#e8f5e9

🤔 为什么需要它？

⚙️ 工作原理

构建流程可以用下面的流程图表示：

┌─────────────────────────────────────────────────────────┐
│                    📝 源代码文件                         │
│                   (.c / .h 文件)                         │
└────────────────────┬────────────────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────────────────┐
│                 🔨 编译器 (Clang)                        │
│          将源代码编译成目标文件 (.obj)                    │
└────────────────────┬────────────────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────────────────┐
│                  🔗 链接器 (Linker)                      │
│    链接成可执行文件 (.exe) 或动态库 (.dll)                │
└────────────────────┬────────────────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────────────────┐
│                  ▶️ 运行程序                             │
│             engine.dll + testbed.exe                    │
└─────────────────────────────────────────────────────────┘

💡 核心思想 构建脚本自动化了整个过程，VS Code 配置让编辑器理解项目结构。

🔧 Kohi 引擎的项目结构

📂 目录树

在这次初始配置中，建立了以下项目结构：

Kohi/                                 # 项目根目录
│
├── 📁 .vscode/                       # VS Code 编辑器配置
│   ├── c_cpp_properties.json        # 🔧 C/C++ 智能感知配置
│   ├── launch.json                  # 🐛 调试器配置
│   ├── tasks.json                   # ⚙️ 构建任务配置
│   ├── settings.json                # 🎨 编辑器设置
│   ├── keybindings.json             # ⌨️ 快捷键配置
│   └── extensions.json              # 🧩 推荐扩展
│
├── 📁 engine/                        # 引擎核心代码
│   ├── 📁 src/
│   │   ├── defines.h                # 📋 基础类型定义和平台检测
│   │   ├── test.h                   # 🧪 测试接口
│   │   └── test.c                   # ✅ 测试实现
│   └── build.bat                    # 🔨 引擎编译脚本
│
├── 📁 testbed/                       # 测试应用程序
│   ├── 📁 src/
│   │   └── main.c                   # 🚀 测试程序入口
│   └── build.bat                    # 🔨 测试程序编译脚本
│
├── 📁 bin/                           # 编译输出目录（自动创建）
│   ├── engine.dll                   # 生成的引擎动态库
│   ├── engine.lib                   # 引擎导入库
│   └── testbed.exe                  # 测试程序可执行文件
│
├── build-all.bat                    # ⚡ 一键编译所有模块
└── .gitignore                       # 🚫 Git 忽略文件配置

📝 核心文件说明

🔷 defines.h - 基础类型系统

主要类型定义：

平台检测宏：

使用场景：

✅ 场景 1：确保数据类型大小在所有平台上一致 ✅ 场景 2：编写跨平台代码时进行条件编译 ✅ 场景 3：简化类型名称，提高代码可读性

💻 实战：搭建开发环境

🎬 快速开始流程

graph TD
    A[开始] --> B[安装工具]
    B --> C[创建目录结构]
    C --> D[编写基础代码]
    D --> E[创建构建脚本]
    E --> F[配置 VS Code]
    F --> G[编译运行]
    G --> H[成功!]

    style A fill:#e1f5ff
    style H fill:#c8e6c9
    style B fill:#fff9c4
    style C fill:#fff9c4
    style D fill:#fff9c4
    style E fill:#fff9c4
    style F fill:#fff9c4
    style G fill:#fff9c4

🛠️ 步骤 1：安装必要的工具

🎯 目标：安装 Kohi 引擎开发所需的基础工具

📦 需要安装的工具

✅ 安装后验证

# 在 PowerShell 或 CMD 中运行
clang --version  # 应该显示 Clang 版本信息

预期输出示例：

clang version 15.0.0
Target: x86_64-pc-windows-msvc
Thread model: posix

💡 重要提示

安装完 Clang 后，需要将其添加到系统环境变量 PATH 中，这样才能在命令行中直接使用。

设置方法：

1. 右键"此电脑" → 属性 → 高级系统设置
2. 环境变量 → 系统变量 → Path → 编辑
3. 新建 → 添加 C:\Program Files\LLVM\bin
4. 确定 → 重启命令行窗口

📁 步骤 2：创建项目结构

🎯 目标：建立符合 Kohi 引擎的目录结构

🖱️ 创建目录

# 创建项目根目录
mkdir Kohi
cd Kohi

# 创建引擎目录
mkdir engine
mkdir engine\src

# 创建测试程序目录
mkdir testbed
mkdir testbed\src

# 创建 VS Code 配置目录
mkdir .vscode

⚠️ 注意事项

• bin/ 目录无需手动创建，编译脚本会自动创建它
• 目录名称区分大小写（虽然 Windows 不区分，但为了跨平台兼容性，建议保持一致）
• 推荐使用命令行创建，确保目录结构正确

📝 步骤 3：编写基础类型定义

🎯 目标：创建引擎的基础类型系统

📄 代码：engine/src/defines.h

#pragma once

// ============================================
// 基础整数类型定义
// ============================================

// 无符号整数类型
typedef unsigned char u8;        // 8位无符号整数  [0, 255]
typedef unsigned short u16;      // 16位无符号整数 [0, 65535]
typedef unsigned int u32;        // 32位无符号整数 [0, 4294967295]
typedef unsigned long long u64;  // 64位无符号整数 [0, 18446744073709551615]

// 有符号整数类型
typedef signed char i8;          // 8位有符号整数  [-128, 127]
typedef signed short i16;        // 16位有符号整数 [-32768, 32767]
typedef signed int i32;          // 32位有符号整数 [-2147483648, 2147483647]
typedef signed long long i64;    // 64位有符号整数 [-9223372036854775808, 9223372036854775807]

// ============================================
// 浮点数类型定义
// ============================================

typedef float f32;               // 32位浮点数（单精度）
typedef double f64;              // 64位浮点数（双精度）

// ============================================
// 布尔类型定义
// ============================================

typedef int b32;                 // 32位布尔类型
typedef char b8;                 // 8位布尔类型

// ============================================
// 静态断言宏定义
// ============================================

#if defined(__clang__) || defined(__gcc__)
#define STATIC_ASSERT _Static_assert
#else
#define STATIC_ASSERT static_assert
#endif

// ============================================
// 编译时类型大小验证
// ============================================

STATIC_ASSERT(sizeof(u8) == 1, "Expected u8 to be 1 byte.");
STATIC_ASSERT(sizeof(u16) == 2, "Expected u16 to be 2 bytes.");
STATIC_ASSERT(sizeof(u32) == 4, "Expected u32 to be 4 bytes.");
STATIC_ASSERT(sizeof(u64) == 8, "Expected u64 to be 8 bytes.");

STATIC_ASSERT(sizeof(i8) == 1, "Expected i8 to be 1 byte.");
STATIC_ASSERT(sizeof(i16) == 2, "Expected i16 to be 2 bytes.");
STATIC_ASSERT(sizeof(i32) == 4, "Expected i32 to be 4 bytes.");
STATIC_ASSERT(sizeof(i64) == 8, "Expected i64 to be 8 bytes.");

STATIC_ASSERT(sizeof(f32) == 4, "Expected f32 to be 4 bytes.");
STATIC_ASSERT(sizeof(f64) == 8, "Expected f64 to be 8 bytes.");

// ============================================
// 布尔值常量
// ============================================

#define TRUE 1
#define FALSE 0

// ============================================
// 平台检测
// ============================================

#if defined(WIN32) || defined(_WIN32) || defined(__WIN32__)
#define KPLATFORM_WINDOWS 1
#ifndef _WIN64
#error "64-bit is required on Windows!"
#endif
#endif

// ============================================
// DLL 导入/导出宏
// ============================================

#ifdef KEXPORT
// 导出（编译引擎时）
#ifdef _MSC_VER
#define KAPI __declspec(dllexport)
#else
#define KAPI __attribute__((visibility("default")))
#endif
#else
// 导入（使用引擎时）
#ifdef _MSC_VER
#define KAPI __declspec(dllimport)
#else
#define KAPI
#endif
#endif

📖 代码详解

💡 为什么使用自定义类型？

问题：标准 C 类型大小不固定 int 可能是 16/32 位 long 在 Windows 64位是 4字节，Linux 64位是 8字节 跨平台开发时容易出错

解决方案：使用固定大小类型 u32 在所有平台都是 4字节 i64 在所有平台都是 8字节 代码更清晰，避免跨平台问题

🧪 步骤 4：创建测试代码

🎯 目标：编写最简单的引擎函数和测试程序，验证 DLL 机制

📄 引擎测试接口：engine/src/test.h

#pragma once

#include "defines.h"

// ============================================
// 测试函数声明
// ============================================

/**
 * @brief 打印一个整数到控制台
 * @param i 要打印的整数
 */
KAPI void print_int(i32 i);

📄 引擎测试实现：engine/src/test.c

#include "test.h"
#include <stdio.h>

// ============================================
// 测试函数实现
// ============================================

void print_int(i32 i) {
    printf("The number is: %i\n", i);  // 打印整数到控制台
}

📄 测试程序入口：testbed/src/main.c

#include <test.h>

// ============================================
// 测试程序主函数
// ============================================

int main(void) {
    print_int(42);  // 调用引擎函数，打印数字 42
    return 0;       // 程序正常退出
}

🔄 工作流程

┌───────────────────┐
│  engine.dll       │  ← 编译引擎，导出 print_int() 函数
│  [KEXPORT 已定义] │
└─────────┬─────────┘
          │
          │ DLL 导出
          ▼
┌───────────────────┐
│  testbed.exe      │  ← 编译测试程序，导入 print_int() 函数
│  [KEXPORT 未定义] │
└───────────────────┘

✅ 验证目标

这个简单的测试验证了以下机制：

• ✔️ DLL 导出/导入是否正常工作
• ✔️ 自定义类型（i32）是否正确定义
• ✔️ 引擎和测试程序能否正确链接

🔨 步骤 5：创建构建脚本

🎯 目标：自动化编译流程，一键构建整个项目

📄 引擎编译脚本：engine/build.bat

REM ============================================
REM Kohi Engine Build Script
REM ============================================
@ECHO OFF
SetLocal EnableDelayedExpansion

ECHO.
ECHO ========================================
ECHO  Building Kohi Engine (DLL)
ECHO ========================================
ECHO.

REM 递归获取所有 .c 文件
SET cFilenames=
FOR /R %%f in (*.c) do (
    SET cFilenames=!cFilenames! %%f
    ECHO Found source file: %%f
)

REM 编译配置
SET assembly=engine
SET compilerFlags=-g -shared -Wvarargs -Wall -Werror
SET includeFlags=-Isrc -I%VULKAN_SDK%/Include
SET linkerFlags=-luser32 -lvulkan-1 -L%VULKAN_SDK%/Lib
SET defines=-D_DEBUG -DKEXPORT -D_CRT_SECURE_NO_WARNINGS

ECHO.
ECHO Building %assembly%.dll...
ECHO.

REM 执行编译
clang %cFilenames% %compilerFlags% -o ../bin/%assembly%.dll %defines% %includeFlags% %linkerFlags%

IF %ERRORLEVEL% EQU 0 (
    ECHO.
    ECHO [SUCCESS] Engine built successfully!
    ECHO.
) ELSE (
    ECHO.
    ECHO [ERROR] Engine build failed!
    ECHO.
)

📊 编译参数详解

📄 测试程序编译脚本：testbed/build.bat

REM ============================================
REM Testbed Build Script
REM ============================================
@ECHO OFF
SetLocal EnableDelayedExpansion

ECHO.
ECHO ========================================
ECHO  Building Testbed Application
ECHO ========================================
ECHO.

REM 递归获取所有 .c 文件
SET cFilenames=
FOR /R %%f in (*.c) do (
    SET cFilenames=!cFilenames! %%f
    ECHO Found source file: %%f
)

REM 编译配置
SET assembly=testbed
SET compilerFlags=-g
SET includeFlags=-Isrc -I../engine/src/
SET linkerFlags=-L../bin/ -lengine.lib
SET defines=-D_DEBUG -DKIMPORT

ECHO.
ECHO Building %assembly%.exe...
ECHO.

REM 执行编译
clang %cFilenames% %compilerFlags% -o ../bin/%assembly%.exe %defines% %includeFlags% %linkerFlags%

IF %ERRORLEVEL% EQU 0 (
    ECHO.
    ECHO [SUCCESS] Testbed built successfully!
    ECHO.
) ELSE (
    ECHO.
    ECHO [ERROR] Testbed build failed!
    ECHO.
)

📄 一键构建脚本：build-all.bat

@ECHO OFF
REM ============================================
REM Build All - Complete Project Build Script
REM ============================================

CLS
ECHO.
ECHO ============================================
ECHO    KOHI ENGINE - BUILD ALL
ECHO ============================================
ECHO.

REM 先编译引擎 DLL
ECHO [STEP 1/2] Building Engine...
PUSHD engine
CALL build.bat
POPD

IF %ERRORLEVEL% NEQ 0 (
    ECHO.
    ECHO [FATAL ERROR] Engine build failed! Stopping build process.
    ECHO.
    EXIT /B %ERRORLEVEL%
)

REM 再编译测试程序
ECHO.
ECHO [STEP 2/2] Building Testbed...
PUSHD testbed
CALL build.bat
POPD

IF %ERRORLEVEL% NEQ 0 (
    ECHO.
    ECHO [FATAL ERROR] Testbed build failed!
    ECHO.
    EXIT /B %ERRORLEVEL%
)

ECHO.
ECHO ============================================
ECHO   BUILD COMPLETE - All assemblies built!
ECHO ============================================
ECHO.
ECHO Output files:
ECHO   - bin/engine.dll
ECHO   - bin/engine.lib
ECHO   - bin/testbed.exe
ECHO.

⚠️ 编译顺序很重要！

必须先编译引擎生成 DLL 和 LIB 文件，然后才能编译测试程序。 build-all.bat 确保了正确的编译顺序，如果任何步骤失败，会立即停止。

⚙️ 步骤 6：配置 VS Code

🎯 目标：让 VS Code 理解项目结构，提供智能提示、编译、调试功能

📄 C/C++ 智能感知配置：.vscode/c_cpp_properties.json

{
    "configurations": [
        {
            "name": "Win32",
            "includePath": [
                "${workspaceFolder}/engine/src/**",
                "${VULKAN_SDK}/include"
            ],
            "defines": [
                "_DEBUG",
                "UNICODE",
                "_UNICODE",
                "KEXPORT"
            ],
            "windowsSdkVersion": "10.0.18362.0",
            "compilerPath": "C:\\Program Files\\LLVM\\bin\\clang.exe",
            "cStandard": "c17",
            "cppStandard": "c++17",
            "intelliSenseMode": "clang-x64"
        }
    ],
    "version": 4
}

💡 配置说明

• includePath: 告诉 IntelliSense 去哪里找头文件
• defines: 预定义宏，与编译时保持一致
• compilerPath: 编译器路径，用于解析代码

📄 构建任务配置：.vscode/tasks.json

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "🔨 Build Engine",
            "type": "shell",
            "windows": {
                "command": "${workspaceFolder}/engine/build.bat"
            },
            "options": {
                "cwd": "${workspaceFolder}/engine"
            },
            "group": "build",
            "presentation": {
                "reveal": "always",
                "panel": "new"
            },
            "problemMatcher": ["$gcc"]
        },
        {
            "label": "🎮 Build Testbed",
            "type": "shell",
            "windows": {
                "command": "${workspaceFolder}/testbed/build.bat"
            },
            "options": {
                "cwd": "${workspaceFolder}/testbed"
            },
            "group": "build",
            "presentation": {
                "reveal": "always",
                "panel": "new"
            },
            "problemMatcher": ["$gcc"]
        },
        {
            "label": "⚡ Build Everything",
            "type": "shell",
            "windows": {
                "command": "${workspaceFolder}/build-all.bat"
            },
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "presentation": {
                "reveal": "always",
                "panel": "new"
            },
            "problemMatcher": ["$gcc"]
        }
    ]
}

快捷键：

• Ctrl+Shift+B → 运行默认构建任务（Build Everything）
• Ctrl+Shift+P → 输入 "Tasks: Run Task" → 选择特定任务

📄 调试配置：.vscode/launch.json

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "🐛 Debug Testbed (Windows)",
            "type": "cppvsdbg",
            "request": "launch",
            "program": "${workspaceFolder}/bin/testbed.exe",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}/bin/",
            "environment": [],
            "console": "newExternalWindow",
            "preLaunchTask": "⚡ Build Everything"
        }
    ]
}

使用方法：

1. 在代码中设置断点（点击行号左侧）
2. 按 F5 启动调试
3. 自动编译并运行，在断点处暂停

📄 编辑器设置：.vscode/settings.json

{
    "C_Cpp.clang_format_style": "{ BasedOnStyle: Google, IndentWidth: 4, ColumnLimit: 0 }",
    "C_Cpp.clang_format_sortIncludes": false,
    "editor.formatOnSave": true,
    "editor.tabSize": 4,
    "files.associations": {
        "*.h": "c",
        "*.c": "c"
    },
    "files.encoding": "utf8",
    "files.eol": "\n"
}

📄 推荐扩展：.vscode/extensions.json

{
    "recommendations": [
        "ms-vscode.cpptools",           // C/C++ 支持
        "slevesque.shader",             // Shader 语法高亮
        "wayou.vscode-todo-highlight"   // TODO 高亮
    ]
}

安装后 VS Code 会自动提示安装这些扩展。

🚀 步骤 7：编译和运行

🎯 目标：验证环境配置，成功编译并运行第一个程序

⚡ 编译项目

方法 1：命令行编译

# 在项目根目录运行
build-all.bat

方法 2：VS Code 快捷键

按 Ctrl+Shift+B

📺 预期编译输出

============================================
   KOHI ENGINE - BUILD ALL
============================================

[STEP 1/2] Building Engine...

========================================
 Building Kohi Engine (DLL)
========================================

Found source file: E:\Kohi\engine\src\test.c

Building engine.dll...

[SUCCESS] Engine built successfully!

[STEP 2/2] Building Testbed...

========================================
 Building Testbed Application
========================================

Found source file: E:\Kohi\testbed\src\main.c

Building testbed.exe...

[SUCCESS] Testbed built successfully!

============================================
  BUILD COMPLETE - All assemblies built!
============================================

Output files:
  - bin/engine.dll
  - bin/engine.lib
  - bin/testbed.exe

▶️ 运行程序

方法 1：命令行运行

cd bin
testbed.exe

方法 2：VS Code 调试运行

按 F5（会自动编译并运行）

✅ 预期运行输出

The number is: 42

📊 深入理解

🔐 DLL 导出/导入机制

在 Windows 上，动态链接库（DLL）中的函数默认是不可见的。需要使用 __declspec(dllexport) 显式导出函数。

工作原理

// 定义了 KEXPORT
#define KAPI __declspec(dllexport)

KAPI void print_int(i32 i);
// 展开为：
// __declspec(dllexport) void print_int(i32 i);

// 未定义 KEXPORT
#define KAPI __declspec(dllimport)

KAPI void print_int(i32 i);
// 展开为：
// __declspec(dllimport) void print_int(i32 i);

🎯 这种设计模式的优势

✅ 跨平台兼容：通过条件编译，可以在 Linux 上使用 __attribute__((visibility("default"))) ✅ 自动切换：同一个头文件，编译引擎时导出，使用引擎时导入 ✅ 行业标准：这是 Windows DLL 开发的标准做法

🤔 为什么编译成 DLL？

Kohi 引擎编译为 **DLL（动态链接库）**而不是静态库，原因如下：

📜 批处理脚本技巧

🔄 延迟变量展开

SetLocal EnableDelayedExpansion
SET var=!var! newValue

为什么需要？

批处理默认在整行解析时展开变量。在循环中修改变量时，需要使用 !var! 而不是 %var%。

示例对比：

SET count=0
FOR %%f in (*.c) do (
    SET count=%count% + 1
)
ECHO %count%

SetLocal EnableDelayedExpansion
SET count=0
FOR %%f in (*.c) do (
    SET count=!count! + 1
)
ECHO !count!

⚠️ 错误处理

IF %ERRORLEVEL% NEQ 0 (
    echo Error:%ERRORLEVEL% && exit
)

说明：

• %ERRORLEVEL%：上一个命令的返回值（0 = 成功，非零 = 失败）
• NEQ 0：不等于 0
• &&：前一个命令成功才执行后一个命令

最佳实践：每个关键步骤后都检查错误，避免错误级联。

🎨 完整示例

示例：添加一个新的引擎函数

🎯 场景描述： 你想为引擎添加一个新的数学函数 add，用于计算两个整数的和。

📝 实现步骤

步骤 1：在头文件中声明函数

engine/src/test.h：

#pragma once
#include "defines.h"

KAPI void print_int(i32 i);
KAPI i32 add(i32 a, i32 b);  // ✨ 新增函数声明

步骤 2：在源文件中实现函数

engine/src/test.c：

#include "test.h"
#include <stdio.h>

void print_int(i32 i) {
    printf("The number is: %i\n", i);
}

// ✨ 新增函数实现
i32 add(i32 a, i32 b) {
    return a + b;  // 返回两数之和
}

步骤 3：在测试程序中使用

testbed/src/main.c：

#include <test.h>

int main(void) {
    i32 result = add(10, 32);  // ✨ 调用新函数
    print_int(result);         // 应该打印 42
    return 0;
}

步骤 4：重新编译运行

build-all.bat
cd bin
testbed.exe

✅ 效果展示

The number is: 42

❓ 常见问题 FAQ

Q1: 编译时提示 "clang 不是内部或外部命令"？

Q2: 链接时提示找不到 engine.lib？

Q3: 为什么需要设置 VULKAN_SDK 环境变量？

REM SET includeFlags=-Isrc -I%VULKAN_SDK%/Include
REM SET linkerFlags=-luser32 -lvulkan-1 -L%VULKAN_SDK%/Lib

SET includeFlags=-Isrc
SET linkerFlags=-luser32

Q4: VS Code 的智能提示不工作？

Q5: 运行时提示 "找不到 engine.dll"？

🐛 故障排查

快速诊断表

🔧 调试技巧

#include <stdio.h>

int main(void) {
    printf("[DEBUG] Program started\n");

    i32 result = add(10, 32);
    printf("[DEBUG] add(10, 32) = %i\n", result);

    print_int(result);

    printf("[DEBUG] Program exiting\n");
    return 0;
}

✏️ 练习题

🎯 基础练习

练习 1：添加字符串打印函数

#pragma once
#include "defines.h"

KAPI void print_int(i32 i);
KAPI void print_string(const char* str);  // ✨ 新增

#include "test.h"
#include <stdio.h>

void print_int(i32 i) {
    printf("The number is: %i\n", i);
}

void print_string(const char* str) {
    printf("%s\n", str);  // 打印字符串
}

#include <test.h>

int main(void) {
    print_string("Hello, Kohi!");
    print_int(42);
    return 0;
}

Hello, Kohi!
The number is: 42

练习 2：添加 .gitignore

# 编译输出目录
bin/

# VS Code 临时文件
.vscode/.browse.VC.db
.vscode/.browse.VC.opendb

# Windows 临时文件
*.tmp
*.log

git status
# 应该看不到 bin/ 目录下的文件

🚀 进阶挑战

挑战 1：实现一个简单的数学库

#pragma once
#include "defines.h"

/**
 * @brief 数学工具库
 * 提供基本的整数运算功能
 */

KAPI i32 math_add(i32 a, i32 b);
KAPI i32 math_subtract(i32 a, i32 b);
KAPI i32 math_multiply(i32 a, i32 b);
KAPI i32 math_divide(i32 a, i32 b);

#include "math_utils.h"
#include <stdio.h>

i32 math_add(i32 a, i32 b) {
    return a + b;
}

i32 math_subtract(i32 a, i32 b) {
    return a - b;
}

i32 math_multiply(i32 a, i32 b) {
    return a * b;
}

i32 math_divide(i32 a, i32 b) {
    if (b == 0) {
        printf("[ERROR] Division by zero!\n");
        return 0;  // 返回 0 作为错误值
    }
    return a / b;
}

#include <test.h>
#include <math_utils.h>

int main(void) {
    print_string("=== Math Utils Test ===");

    print_int(math_add(10, 5));       // 15
    print_int(math_subtract(10, 5));  // 5
    print_int(math_multiply(10, 5));  // 50
    print_int(math_divide(10, 5));    // 2
    print_int(math_divide(10, 0));    // 错误：除零

    return 0;
}

=== Math Utils Test ===
The number is: 15
The number is: 5
The number is: 50
The number is: 2
[ERROR] Division by zero!
The number is: 0

挑战 2：实现类型大小查询函数

=== Type Sizes ===
u8:  1 byte(s)
u16: 2 byte(s)
u32: 4 byte(s)
...

#pragma once
#include "defines.h"

KAPI void print_int(i32 i);
KAPI void print_type_sizes(void);  // ✨ 新增

#include "test.h"
#include <stdio.h>

void print_int(i32 i) {
    printf("The number is: %i\n", i);
}

void print_type_sizes(void) {
    printf("=== Type Sizes ===\n");
    printf("u8:  %zu byte(s)\n", sizeof(u8));
    printf("u16: %zu byte(s)\n", sizeof(u16));
    printf("u32: %zu byte(s)\n", sizeof(u32));
    printf("u64: %zu byte(s)\n", sizeof(u64));
    printf("\n");
    printf("i8:  %zu byte(s)\n", sizeof(i8));
    printf("i16: %zu byte(s)\n", sizeof(i16));
    printf("i32: %zu byte(s)\n", sizeof(i32));
    printf("i64: %zu byte(s)\n", sizeof(i64));
    printf("\n");
    printf("f32: %zu byte(s)\n", sizeof(f32));
    printf("f64: %zu byte(s)\n", sizeof(f64));
    printf("\n");
    printf("b8:  %zu byte(s)\n", sizeof(b8));
    printf("b32: %zu byte(s)\n", sizeof(b32));
    printf("==================\n");
}

#include <test.h>

int main(void) {
    print_type_sizes();
    return 0;
}

🔗 相关资源

📚 Kohi 引擎资源

📖 扩展阅读

🚀 下一步学习

graph LR
    A[当前：Windows环境配置] --> B[02 - Linux环境配置]
    A --> C[03 - 日志系统实现]
    A --> D[04 - 内存管理]
    B --> E[05 - 平台抽象层]
    C --> E
    D --> E

    style A fill:#c8e6c9
    style B fill:#fff9c4
    style C fill:#fff9c4
    style D fill:#fff9c4
    style E fill:#ffccbc

推荐学习路径：

1. 📌 必学：

   • 02 - Linux 环境配置 - 实现跨平台开发
   • 03 - 日志系统实现 - 为引擎添加日志功能
   • 04 - 内存管理 - 自定义内存分配器

2. ⭐ 进阶：

   • 构建系统优化 - 使用 CMake 替代批处理脚本
   • 单元测试 - 为引擎添加测试框架
   • 性能分析 - 学习性能分析工具

📝 总结

本节内容回顾：

🛤️ 你现在的位置

✅ Windows 环境配置（当前）
    │
    ├─→ Linux 环境配置
    ├─→ 日志系统
    ├─→ 断言和错误处理
    ├─→ 内存管理
    └─→ 平台抽象层
        └─→ 窗口系统
            └─→ 输入处理
                └─→ 渲染系统...

通过这次配置，你建立了一个可扩展的引擎开发框架。在后续章节中，我们将在这个基础上添加更多功能，如日志系统、内存管理、平台抽象层、渲染系统等。

📌 重要提示

本教程是一个系列教程的第一部分。每个教程都会在前一个的基础上构建新功能。建议按顺序学习，这样才能理解整个引擎的设计思路。

---

📅 本教程更新时间：2025-01-18 🏷️ Kohi 引擎版本：v0.1.0 (Initial Setup) 📖 参考提交：06fcdd94c82d5871bae6a2883850f53138b85f20

---

📖 关注公众号

关注我，领取章节视频教程

---

💖 支持作者

如果这篇教程对你有帮助，欢迎请作者喝杯咖啡 ☕

您的支持是我持续创作的动力！

感谢每一位支持者！🙏

📅 最后更新：2025-11-19 ✍️ 作者：上手实验室