在统信UOS中安装FreeCAD需按版本选择路径：UOS V20/V23用APT安装；V24或教育版须用PPA源或AppImage，避免因PySide2缺失导致启动黑屏，并通过fc-list :lang=zh验证中文字体、QT_QPA_PLATFORMTHEME=qt5ct解决草图工具栏灰显问题。
在统信UOS系统中安装并正常使用FreeCAD，需避开Windows安装包直接双击失败、依赖缺失导致启动黑屏、中文界面不生效等典型问题。UOS对FreeCAD原生支持有限，必须按系统适配层级选择对应路径，否则安装后无法启动或功能残缺。
确认UOS版本与FreeCAD兼容性
打开终端，执行 cat /etc/os-release 查看UOS版本号。若为UOS V20（2021）或V23（2023），可直接通过APT安装稳定版；若为最新UOS V24（2025）或教育版，优先使用PPA源或AppImage方式——【V24默认仓库中的freecad包已过时，启动后会报错“ImportError: No module named 'PySide2'”】，必须替换为社区维护的更新源。
方法一：APT安装（仅限UOS V20/V23）
打开终端，依次执行：
sudo apt update → sudo apt install freecad freecad-common freecad-doc
安装完成后，执行 freecad --version 检查输出是否为 0.20.2 或更高。若显示 0.19.x，则说明仓库版本陈旧，需跳转至方法二。
方法二：PPA源安装（推荐UOS V23/V24）
第一步：添加FreeCAD稳定版PPA源
sudo add-apt-repository ppa:freecad-maintainers/freecad-stable
第二步：更新软件列表并安装
sudo apt update → sudo apt install freecad
第三步：验证Python模块完整性
启动FreeCAD后，在Python控制台输入 import PySide2，无报错即表示GUI框架加载成功。若提示模块缺失，执行 sudo apt install python3-pyside2.qtcore python3-pyside2.qtgui python3-pyside2.qtsvg 补全依赖。
方法三：AppImage免安装运行（全版本通用）
访问 https://github.com/FreeCAD/FreeCAD/releases ，下载最新版 FreeCAD_*.AppImage 文件（如 FreeCAD_1.0.2-conda-Linux-x86_64.AppImage）。
右键该文件 → 属性 → 权限 → 勾选“允许作为程序执行”。
双击启动即可，无需root权限，也不修改系统环境——【此方式启动后默认为英文界面，需手动设置语言】。
汉化与基础配置
启动FreeCAD后，点击顶部菜单栏 Edit → Preferences → General → Language → 选择“简体中文” → 点击OK。
重启软件生效。若界面仍为英文，检查是否遗漏了中文字体：终端执行 fc-list :lang=zh，若无输出，需手动安装思源黑体：sudo apt install fonts-noto-cjk。
进入Part Design工作台，新建Body，尝试绘制一个矩形草图——这一步能验证Sketcher模块是否正常加载。若草图工具栏灰显或点选无响应，说明Qt平台插件未正确挂载，需在终端用 QT_QPA_PLATFORMTHEME=qt5ct freecad 启动。
