一、前提说明
本文档为Linux系统（x64架构/arm64）专属，包含Qt6.7.3在线安装（使用指定清华镜像在线安装器）和fcitx编译完整步骤，所有命令可直接复制粘贴执行，无需手动修改（除Qt安装路径可按需调整外），全程无脑操作，解决Qt6环境下无法输入中文的问题。
核心逻辑：安装Qt6.7.3后，编译fcitx-qt5插件并指定Qt6路径，生成适配Qt6的中文输入插件，解决输入异常问题。
二、Qt6.7.3 在线安装（使用online_installers）
步骤1：下载在线安装器（清华镜像，速度快）
打开终端，输入以下命令，下载Linux x64架构的4.10.0版本在线安装器（路径默认当前用户目录，可自行修改）：
cd ~
wget https://mirrors.tuna.tsinghua.edu.cn/qt/archive/online_installers/4.10/qt-online-installer-linux-x64-4.10.0.run
arm64请访问https://mirrors.tuna.tsinghua.edu.cn/qt/archive/online_installers/4.10自行下载
步骤2：赋予安装器执行权限
终端输入以下命令，给下载的安装器添加可执行权限：
chmod +x qt-online-installer-linux-x64-4.10.0.run
步骤3：指定阿里云镜像安装（解决下载慢问题）
终端输入以下命令，启动安装器并切换到阿里云镜像（无需手动设置镜像，命令已自带）：
./qt-online-installer-linux-x64-4.10.0.run –mirror https://mirrors.aliyun.com/qt
步骤4：安装器图形界面操作（无脑下一步，重点注意2点）
执行上述命令后，会弹出Qt安装图形界面，按以下提示操作，全程默认即可，仅2处需要注意：
登录Qt账户：没有账户的话，点击界面“注册”，按提示完成注册（免费），注册后登录即可，不登录无法继续安装。
选择组件：
勾选“Qt 6.7.3”（找到对应版本，勾选主程序）；
勾选“MinGW 11.2.0 64-bit”或“GCC 64-bit”（二选一，建议勾选GCC，适配后续fcitx编译）；
勾选“Sources”（Qt源码，可选，建议勾选，不影响中文输入）；
其他组件默认勾选即可，无需额外修改。
其余步骤（开源义务、许可协议、开始菜单快捷方式等）全部点击“下一步”“同意”即可，等待安装完成（约30分钟，取决于网络速度）。
三、编译fcitx（解决Qt6无法输入中文问题）
步骤1：安装编译依赖（必装，缺一不可）
终端依次输入以下3条命令，安装所有依赖包，复制粘贴执行即可，无需手动确认（命令已带自动确认参数）：
sudo apt install libgl1-mesa-dev libglu1-mesa-dev freeglut3-dev -y
sudo apt install -y libxkbcommon-dev libxkbcommon-x11-dev
sudo apt install extra-cmake-modules -y
步骤2：拉取fcitx-qt5仓库（从GitHub克隆）
终端输入以下命令，克隆仓库到当前用户目录（路径默认，无需修改）：
cd ~
git clone https://github.com/fcitx/fcitx-qt5.git
步骤3：修改CMakeLists.txt文件（适配Qt6）
终端输入以下命令，直接修改文件参数（无需手动打开编辑，命令自动替换）：
vim CMakeLists.txt
# 修改ENABLE_QT5为off，ENABLE_QT6为on
步骤4：创建编译目录并进入
终端输入以下命令，创建build目录（用于存放编译文件）并进入：
cd ~/fcitx-qt5
mkdir build
cd build
步骤5：cmake配置（指定Qt6路径，关键步骤）
终端输入以下完整命令（复制整行，不要拆分），配置cmake编译参数，默认Qt6安装路径，需要根据自己的qt目录做修改：
cmake .. -DENABLE_LIBRARY=false -DENABLE_QT5=Off -DENABLE_QT6=On -DQt6_DIR=/home/pc/Qt6/6.7.3/gcc_64/lib/cmake/Qt6 -DQt6Core_DIR=/home/pc/Qt6/6.7.3/gcc_64/lib/cmake/Qt6Core -DQt6Gui_DIR=/home/pc/Qt6/6.7.3/gcc_64/lib/cmake/Qt6Gui -DQt6Widgets_DIR=/home/pc/Qt6/6.7.3/gcc_64/lib/cmake/Qt6Widgets -DQt6DBus_DIR=/home/pc/Qt6/6.7.3/gcc_64/lib/cmake/Qt6DBus -DQt6Concurrent_DIR=/home/pc/Qt6/6.7.3/gcc_64/lib/cmake/Qt6Concurrentsudo
步骤6：编译（生成插件）
终端输入以下命令，开始编译（时间约5-10分钟，取决于电脑配置）：
make
四、关键说明（必看）
编译完成后，插件路径：~/fcitx-qt5/build/qt6/platforminputcontext/libfcitx5platforminputcontextplugin.so，需要将此so移动到自己的程序对应的qt-plugin中
如果编译失败，大概率是以下2个原因：
Qt6安装路径修改过：需对应修改步骤5中cmake命令里的“/home/pc/Qt6/6.7.3/gcc_64”路径，改为实际安装路径。
依赖未安装完整：重新执行步骤1的3条依赖安装命令，确保所有依赖都安装成功。
所有命令均为Linux系统专属，Windows/Mac系统不适用。
全程无需手动编辑文件、修改参数，复制粘贴终端命令即可完成操作，实现无脑部署。
