必须先确认uos版本再选择安装路径：v20/v23用apt安装freecad 0.20.x，v24或教育版须用ppa源或appimage，否则因pyside2缺失导致黑屏、草图工具栏灰显；apt安装后需验证版本≥0.20.2，ppa安装后需在python控制台执行import pyside2验证模块加载，appimage方式需手动授权执行并设置中文界面。
在统信UOS系统中安装FreeCAD，必须先确认当前系统版本再选择对应安装路径，否则V24用户直接用APT安装会因PySide2缺失导致启动黑屏、草图工具栏灰显，V20/V23用户跳过APT而用AppImage则浪费系统集成优势，且无法通过系统更新自动维护。
确认UOS版本号
打开终端（Ctrl+Alt+T），执行：
cat /etc/os-release
重点查看VERSION_ID字段：若显示“20”或“23”，说明是UOS V20（2021）或V23（2023），可走APT原生安装；若显示“24”，或版本号为“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源安装。
PPA源安装（推荐UOS V23/V24）
第一步：添加稳定版PPA源
sudo add-apt-repository ppa:freecad-maintainers/freecad-stable
第二步：更新并安装
sudo apt update → sudo apt install freecad
第三步：验证PySide2是否加载成功
启动FreeCAD → 点击菜单栏“宏”→“Python控制台”→输入 import PySide2 并回车。无任何报错即为正常；若提示模块缺失，必须立刻补全：
sudo apt install python3-pyside2.qtcore python3-pyside2.qtgui python3-pyside2.qtsvg
AppImage免安装运行（全版本通用）
访问 https://github.com/FreeCAD/FreeCAD/releases，下载最新 AppImage 文件（如 FreeCAD_1.0.2-conda-Linux-x86_64.AppImage）。
右键该文件 → 属性 → 权限 → 勾选“允许作为程序执行”。
双击启动即可——【此方式启动后默认为英文界面，需手动设置语言】。
