在统信UOS系统中推荐通过源码编译安装FocusWriter：先确认CPU架构（x86_64或aarch64），安装基础依赖，克隆仓库后按架构指定Qt5路径配置CMake，编译安装并设为简体中文、调整中文字体与页边距以优化写作体验。
在统信UOS系统中快速安装并启动FocusWriter全屏写作工具，避开依赖缺失、界面异常或无法启动等常见问题，需绕过应用商店不可用、源码编译门槛高、第三方包不兼容等障碍。
确认系统架构与基础依赖
打开终端，执行 uname -m 查看CPU架构：输出为 x86_64 表示amd64平台，输出为 aarch64 则为arm64（如飞腾、鲲鹏芯片）。这一步必须做，【后续所有安装方式都依赖此结果】。
确保已安装基础构建工具：运行 sudo apt update && sudo apt install -y build-essential cmake qt5-default libqt5svg5-dev libqt5webkit5-dev。若提示 qt5-default 不可用，改用 qtbase5-dev 替代——UOS V23起已将部分Qt包名调整。
方法一：APT源安装（仅限UOS V20/V23官方仓库已收录版本）
目前UOS社区仓库未上架FocusWriter，该方法仅适用于已手动添加第三方可信源的用户。普通用户跳过此节。
如你已配置好支持FocusWriter的APT源，依次执行：
sudo apt update → sudo apt install focuswriter
安装完成后直接在应用菜单搜索“FocusWriter”启动。若启动失败且报错含 libQt5WebEngineCore.so.5，说明UOS默认未预装WebEngine模块，需额外运行 sudo apt install libqt5webengine5。
方法二：从源码编译安装（推荐，兼容性最强）
这是UOS下最可靠的方式，能确保适配本地Qt版本和桌面环境，避免二进制包因glibc或Qt ABI不匹配导致崩溃。
第一步：克隆官方镜像仓库git clone https://gitcode.com/gh_mirrors/fo/focuswriter ~/src/focuswriter
第二步：进入项目目录并创建构建路径cd ~/src/focuswriter && mkdir -p build && cd build
第三步：配置CMake（关键！必须指定Qt5路径，否则可能误用Qt6）cmake -DCMAKE_PREFIX_PATH=/usr/lib/x86_64-linux-gnu/qt5 ..（amd64用户）cmake -DCMAKE_PREFIX_PATH=/usr/lib/aarch64-linux-gnu/qt5 ..（arm64用户）
第四步：编译并安装cmake --build . --parallel $(nproc) && sudo cmake --install .
这一步耗时约3～8分钟，取决于CPU核心数。编译过程若卡在 Scanning dependencies of target focuswriter 超过5分钟，可按 Ctrl+C 中断后重试——偶尔因CMake缓存导致假死。
第五步：验证安装
终端输入 focuswriter --version，返回类似 FocusWriter 1.10.5 即成功。
首次启动与中文写作配置
点击应用菜单中的FocusWriter图标启动，首次运行会自动生成配置目录 ~/.config/focuswriter/。
点击菜单栏 文件 → 首选项 → 界面，将“语言”下拉框改为“简体中文”，重启程序生效。不改这里，整个界面包括快捷键提示全是英文，影响操作效率。
在 文档 → 页面设置 中，建议将页边距设为“窄”（2cm），字体选“Noto Sans CJK SC”或“Source Han Sans SC”，字号调至14～16pt——UOS默认中文字体渲染较淡，小字号易发虚。
启用专注模式：按 F11 进入全屏，再按一次 F11 可隐藏顶部菜单栏和底部状态栏，只留纯文本区域。此时敲击任意字母自动唤出菜单，无需鼠标。
