社区支持¶

SOUI 拥有一个活跃的开发者社区，您可以通过多种渠道获取帮助、分享经验和贡献代码。

官方渠道¶

GitHub 仓库¶

主仓库: https://github.com/soui4/soui
文档仓库: https://gitee.com/setoutsoft/soui-docs

在 GitHub 上您可以： - 提交 Issue 报告问题 - 提交 Pull Request 贡献代码 - 查看项目更新和路线图 - 参与讨论和代码审查

Gitee 镜像¶

镜像仓库: https://gitee.com/setoutsoft/soui4

对于国内用户，Gitee 提供了更快的访问速度。

社区交流¶

QQ 群¶

SOUI 技术交流1群: 229313785
SOUI 技术交流2群: 385438344

QQ 群是获取实时帮助的最佳途径，您可以在其中： - 与其他开发者交流经验 - 获取官方技术支持 - 参与技术讨论 - 分享项目成果

论坛社区¶

官方论坛: https://www.soui.com.cn/

论坛提供了更正式的交流平台： - 发布技术文章 - 提出技术问题 - 分享项目案例 - 参与专题讨论

问题反馈指南¶

提交 Issue¶

在提交 Issue 前，请确保：

搜索现有 Issue
使用关键词搜索相关问题
查看是否已有解决方案
避免重复提交

提供详细信息

标题：简明扼要地描述问题

环境信息：
- SOUI 版本：
- 操作系统：
- 编译器版本：
- IDE 版本：

问题描述：
- 详细描述问题现象
- 提供重现步骤
- 附加错误信息

最小重现代码：
- 提供能重现问题的最小代码示例

使用模板 ```` ## 环境信息
SOUI 版本: 3.0.0
操作系统: Windows 10 20H2
编译器: Visual Studio 2019
IDE: Visual Studio 2019

## 问题描述在使用 SListView 控件时，设置特定属性后程序崩溃。

## 重现步骤 1. 创建 SListView 控件 2. 设置 itemHeight="50" 3. 运行程序 4. 程序崩溃

## 错误信息 Exception: Access violation reading location 0x00000000

## 最小重现代码 xml <listview itemHeight="50"> <item>测试项</item> </listview> ```

贡献指南¶

代码贡献¶

欢迎通过 Pull Request 贡献代码：

Fork 仓库
Fork 主仓库到您的账户
创建功能分支
代码规范
遵循现有代码风格
添加必要的注释
提供单元测试（如适用）
提交要求
每个 PR 解决一个具体问题
提供清晰的描述
确保 CI 构建通过

文档贡献¶

文档是开源项目的重要组成部分，您可以通过以下方式贡献：

改进现有文档
修正错误和不准确的描述
补充缺失的内容
优化表达和结构
添加新文档
编写教程和指南
创建示例和最佳实践
翻译文档
提交方式
Fork 文档仓库
修改相关文件
提交 Pull Request

学习资源¶

官方示例¶

SOUI 仓库中包含丰富的示例代码： - 基础控件使用示例 - 高级功能演示 - 最佳实践展示

教程和文档¶

本文档中心提供完整的使用指南
官方博客发布技术文章
视频教程（如有）

第三方资源¶

社区成员分享的项目和经验
技术博客和文章
开源项目参考

社区行为准则¶

为了维护良好的社区环境，请遵守以下准则：

尊重他人¶

使用礼貌用语
尊重不同观点
避免人身攻击

有效沟通¶

提供清晰的问题描述
使用合适的频道讨论
避免重复提问

互助精神¶

乐于帮助他人
分享经验和知识
积极参与社区建设

技术讨论¶

基于事实进行讨论
提供可验证的信息
避免无意义的争论

常见问题¶

如何快速获得帮助？¶

在 QQ 群中提问（最快）
在论坛发布问题
提交 GitHub Issue

提问时需要注意什么？¶

提供完整的环境信息
描述清楚问题现象
附上最小重现代码
使用合适的标签

如何贡献文档？¶

Fork 文档仓库
修改相关文档
提交 Pull Request
等待审核合并

社区活动¶

定期技术分享
代码审查活动
项目展示交流

通过积极参与社区，您不仅能解决技术问题，还能与其他开发者建立联系，共同推动 SOUI 生态的发展。