三步掌握CJQT：仓颉语言Qt开发全家桶从入门到实践

一、CJQT是什么：跨平台GUI开发新选择

CJQT是基于QT5.14.2构建的仓颉语言绑定库，将Qt的强大功能与仓颉语言的简洁语法结合，为开发者提供跨平台GUI解决方案。该项目封装了QWidgets、QCore、QGui等核心模块，支持64位Windows/Linux系统，内置俄罗斯方块、记事本等示例程序，让GUI开发更高效。

核心价值：

• 语法适配：仓颉语言风格的API封装，降低Qt学习成本
• 跨平台支持：一套代码运行在Windows和Linux系统
• 丰富组件：涵盖从基础控件到复杂布局的完整组件库

二、15分钟环境部署：从源码到运行

2.1 环境准备清单

• 操作系统：64位Windows 10/11或Linux发行版
• 基础依赖：
  • 64位C++编译器（如gcc-mingw64）
  • QT5.14.2开发环境
  • 仓颉语言运行时

2.2 源码获取

git clone https://gitcode.com/Cangjie-TPC/CJQT

2.3 QT环境配置 🛠️

Linux系统：

# 下载QT安装包
wget https://download.qt.io/archive/qt/5.14/5.14.2/qt-opensource-linux-x64-5.14.2.run

# 赋予执行权限
chmod +x qt-opensource-linux-x64-5.14.2.run

# 运行安装程序
./qt-opensource-linux-x64-5.14.2.run

环境变量配置：

export PATH=$PATH:/opt/Qt5.14.2/5.14.2/gcc_64/bin

注意事项：安装时需勾选"Desktop gcc 64-bit"组件，确保Qt5Core、Qt5Widgets等开发库被正确安装

2.4 编译与构建

# 进入项目目录
cd CJQT

# 编译Native库
cd native
mkdir build && cd build
cmake ..
make

# 返回项目根目录编译CJQT
cd ../..
cjpm build

三、核心功能实践：3个示例掌握基础应用

3.1 布局管理：QFrame容器组件

QFrame是CJQT中最基础的容器组件，支持多种边框样式和背景设置，常用于界面区域划分。

图：QFrame组件的四种边框样式和背景色展示

基础用法：

import widgets

fn main() {
    let frame = QFrame.new()
    frame.setFrameShape(QFrame.StyledPanel)
    frame.setStyleSheet("background-color: #4169E1")
    frame.show()
}

3.2 文本编辑：简易记事本应用

CJQT的QTextEdit组件提供完整的文本编辑功能，支持格式设置、文件操作等核心功能。

图：基于CJQT开发的记事本应用，包含菜单栏、工具栏和文本编辑区

适用场景：快速开发文本编辑器、日志查看器等轻量级文本处理工具

3.3 游戏开发：俄罗斯方块实例

通过CJQT的图形绘制和事件处理能力，可以构建简单的游戏应用。

图：CJQT实现的俄罗斯方块游戏，包含游戏区、下一方块预览和控制说明

运行方法：

# Linux系统
cd example/tetris
./run.sh

# Windows系统
cd example\tetris
.\run.ps1

四、进阶配置与优化

4.1 项目配置文件修改

当Native库构建路径变更时，需同步修改cjpm.toml文件：

[native]
nativeQt = "新的Native库路径"

4.2 常见问题解决

• 编译错误：检查Qt环境变量是否配置正确
• 运行时缺少库：将Qt的lib目录添加到系统库路径
• 中文显示异常：在代码中设置字体为支持中文的字体

五、扩展资源

示例代码路径

• 基础组件示例：example/hello/
• 布局管理示例：example/frame/
• 高级应用示例：example/feeluown/

文档资源

• API文档：doc/api/index.html
• 开发指南：doc/develop/develop.md
• 框架设计：doc/design.md

开发工具

• 项目构建：build_native.sh（Linux）/build_native.ps1（Windows）
• 测试脚本：test.sh