StellarX v4.0.0 教程中心

StellarX 教程中心已更新至 v4.0.0，当前包含 00 到 15 共 16 篇教程，支持集中阅读、章节搜索、代码复制、本文目录导航，以及右侧 AI 助教对话。

教程中心主要面向 C++ 初学者、StellarX 使用者，以及正在从命令行程序过渡到 GUI 桌面开发的学习者。建议使用电脑浏览器访问，阅读体验会更加完整。

本文末尾提供教程中心入口。如果是第一次使用 StellarX，建议先读完本文。

v4.0.0 更新重点

本次教程已按 StellarX v4.0.0 公开接口和官方发布包全面更新，主要包括：

• 使用 ControlHandle 管理控件身份，通过 findControl() 安全查询控件。
• Window 和 Canvas 支持受控的添加、删除和清空，回调中的结构变更会延迟到安全时机提交。
• TabControl 改用 addTab() 和 tryAddToPage()，并补充逻辑索引、所有权返还和重复标题行为说明。
• 布局章节改用水平轴、垂直轴独立的锚点、尺寸和对齐策略。
• 补充 Table 重置与分页重绘、MBCS 文本边界、SxLog 配置失败语义等内容。
• 集成章节已对齐官方 x64 / MSVC v143 发布包，区分 Debug /MDd 和 Release /MD 静态库。
• 源码集成说明已补充 src/internal 私有头文件的正确目录结构。

教程内容

教程中心包含：

00 教程总览
01 环境安装与版本说明
02 第一个 StellarX 窗口
03 Window 生命周期与事件循环
04 Label / Button / TextBox 基础控件
05 Canvas 容器与控件层级
06 布局系统与窗口自适应
07 Table 表格控件
08 TabControl 页签容器
09 Dialog 与 MessageBox 对话框
10 样式、字体、颜色和背景
11 日志系统与调试建议
12 完整小项目实战：任务清单
13 常见错误与排查
14 使用与构建静态库
15 API 速查表

第一次学习建议按顺序阅读：

01 → 02 → 03 → 04 → 05 → 06

已经跑通示例程序的读者，可以优先查看：

03 控件所有权与延迟结构变更
06 布局系统
07 Table
08 TabControl
11 日志系统
14 使用与构建静态库
15 API 速查表

版本与集成方式

教程内容对应 StellarX v4.0.0。官方发布包提供 Windows x64 / MSVC v143 的 Debug 和 Release 静态库。

可以根据项目需求选择：

官方 lib 集成：公开头文件 + 与配置匹配的 .lib
源码集成：公开头文件 + 11 个 .cpp + src/internal 私有头文件

不要在同一个业务项目中同时编译 StellarX .cpp 并链接 StellarX .lib。

v4.0.0 发布页：

https://github.com/Ysm-04/StellarX/releases/tag/v4.0.0

AI 助教

教程中心右侧已接入 AI 助教，可以围绕当前章节内容进行提问，例如：

总结本章
解释本章
生成练习题
指出易错点
继续追问当前章节内容

AI 助教会结合当前正在阅读的章节内容进行回答，适合用于理解概念、梳理代码、排查常见错误和辅助学习。

当前使用服务器后端代理方式接入，用户不需要填写 API Key，也不需要配置 Base URL、Model 等信息，打开教程中心即可直接使用。

快捷指令只会填入输入框，不会自动发送，可以根据自己的问题修改后再提问。

使用说明

进入教程中心后，可以按以下方式使用：

1. 左侧选择教程章节
2. 中间阅读教程内容
3. 右侧查看本文目录或使用 AI 助教
4. 遇到不理解的内容，可以直接向 AI 助教追问

例如可以这样提问：

这章主要讲了什么？
这段代码为什么要这样写？
根据当前章节生成 3 道练习题
我刚学 C++，帮我用更简单的话解释这一节

需要注意的是，AI 助教主要用于辅助学习，具体接口和代码行为仍以 StellarX v4.0.0 官方文档、源码和实际运行结果为准。

进入教程中心

https://blog.stellarx-gui.top/stellarx-tutorial/

按钮入口：

进入 StellarX 教程中心