跨平台GUI开发新选择：CJQT仓颉语言绑定库完全指南

CJQT作为Qt框架的仓颉语言绑定库，提供了符合仓颉语言风格的Qt API封装，基于QT5.14.2版本构建，支持64位系统，涵盖QWidgets、QCore、QGui等模块，是开源项目中实现跨平台GUI开发的理想选择。

一、核心优势

• 原生语法适配：采用仓颉语言特性重构Qt API，提供符合仓颉开发者习惯的接口设计，降低学习成本。
• 跨平台兼容：一次编码即可在Windows和Linux系统运行，完美支持64位架构，满足多平台开发需求。
• 丰富示例资源：内置俄罗斯方块、记事本等实用示例程序，覆盖常见GUI开发场景，加速项目开发进程。

二、环境准备

2.1 系统兼容性对比

系统类型	编译器要求	依赖环境	环境变量配置路径
Windows	mingw64	QT5.14.2	C:\Qt\5.14.2\mingw73_64\bin
Linux	gcc-mingw64	QT5.14.2	/opt/Qt5.14.2/5.14.2/gcc_64/bin

2.2 零基础配置步骤

你需要准备：

• 64位操作系统（Windows 10/11或Linux发行版）
• 已安装的C++编译器
• QT5.14.2开发环境

1. 获取项目代码

git clone https://gitcode.com/Cangjie-TPC/CJQT  # 克隆项目仓库

2. 安装QT5.14.2

# Linux系统示例
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  # 运行安装程序

3. 配置环境变量

# 临时生效（当前终端）
export PATH=$PATH:/opt/Qt5.14.2/5.14.2/gcc_64/bin

# 永久配置（Linux系统）
echo 'export PATH=$PATH:/opt/Qt5.14.2/5.14.2/gcc_64/bin' >> ~/.bashrc
source ~/.bashrc

[!TIP] 配置完成后，可通过qmake -v命令验证QT环境是否安装成功，成功会显示QT版本信息。

三、快速上手

3.1 编译项目

1. 编译Native库

cd CJQT/native  # 进入Native目录
mkdir build && cd build  # 创建构建目录
cmake ..  # 生成Makefile
make -j4  # 多线程编译

2. 编译CJQT主项目

cd ../../  # 返回项目根目录
cjpm build  # 使用cjpm构建项目

3.2 验证安装

# 检查项目结构
ls -l ./src  # 查看源码目录
ls -l ./example  # 查看示例程序目录

四、深度应用

4.1 场景化应用指南

4.1.1 记事本应用

cd ./example/notepad  # 进入记事本示例目录
./run.sh  # Linux运行
# 或
.\run.ps1  # Windows PowerShell运行

图：CJQT记事本示例程序界面，支持文本编辑、格式设置等功能

4.1.2 俄罗斯方块游戏

cd ./example/tetris  # 进入俄罗斯方块示例目录
./run.sh  # Linux运行

图：CJQT俄罗斯方块游戏界面，展示游戏区域和控制说明

4.1.3 界面布局演示

cd ./example/frame  # 进入界面布局示例目录
./run.sh  # Linux运行

图：CJQT界面布局示例，展示多区域颜色块布局效果

4.2 避坑指南

[!TIP]

• 若Native构建目录变更，需同步修改./cjpm.toml中的nativeQt路径
• 运行示例程序前，确保已完成项目编译
• Windows系统需使用PowerShell执行.ps1脚本

4.3 高级配置

修改配置文件./cjpm.toml可自定义构建选项：

# 示例配置
[build]
nativeQt = "./native/build"  # Native库构建路径
target = "release"  # 构建目标类型

通过以上步骤，你已经掌握了CJQT项目的安装配置和基础应用。这个开源项目不仅提供了Qt框架的仓颉语言封装，还通过丰富的示例程序帮助开发者快速上手跨平台GUI开发。无论是简单的界面展示还是复杂的交互应用，CJQT都能满足你的开发需求。