仓颉语言Qt开发实战：跨平台GUI开源库快速上手指南

零基础环境配置指南

如何在Linux系统搭建CJQT开发环境？只需三步完成QT5.14.2部署：

1. 下载QT安装包

wget https://download.qt.io/archive/qt/5.14/5.14.2/qt-opensource-linux-x64-5.14.2.run

2. 执行安装程序

chmod +x qt-opensource-linux-x64-5.14.2.run
./qt-opensource-linux-x64-5.14.2.run

3. 配置环境变量

echo 'export PATH=$PATH:/opt/Qt5.14.2/5.14.2/gcc_64/bin' >> ~/.bashrc
source ~/.bashrc

💡 验证方法：在终端输入qmake -v，显示QT版本信息即配置成功。

5分钟启动框架示例程序

克隆项目仓库后如何快速运行演示程序？

1. 获取源码

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

2. 编译Native库

cd native
mkdir build && cd build
cmake ..
make -j4

3. 运行框架示例

cd ../example/frame
./run.sh

图：CJQT框架核心模块架构示意图，展示仓颉语言与Qt框架的层级关系

窗口组件开发实例教程

如何用仓颉语言创建带边框的彩色面板？以QFrame组件为例：

import widgets

func main() {
    let frame = QFrame.new()
    frame.setFrameShape(Box)
    frame.setStyleSheet("background-color: #4CAF50; border: 2px solid gray;")
    frame.resize(200, 200)
    frame.show()
}

运行效果： 图：使用CJQT开发的多色QFrame组件演示，展示仓颉语言对Qt控件的封装效果

常见问题速查

Q：编译时报"找不到Qt5Widgets"错误怎么办？ A：检查环境变量是否配置正确，执行echo $PATH确认Qt bin目录已添加

Q：运行示例程序提示缺少.so文件？ A：将native/build/lib目录添加到系统库路径：

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/to/CJQT/native/build/lib

Q：如何修改示例程序窗口大小？ A：在源码中找到resize(width, height)方法，调整参数值后重新编译

Q：CJQT支持哪些Qt模块？ A：目前已封装QCore、QGui、QWidgets核心模块，完整列表见src/目录下的模块文件

Q：编译耗时过长如何优化？ A：使用多线程编译：make -j$(nproc)，充分利用CPU核心