必须先执行sudo apt update更新源，再用sudo apt install darktable安装；若提示“无法定位软件包”，需先启用community源，安装后首次运行自动初始化配置并支持raw导入与无损编辑。
要在统信UOS系统上安装并立即开始处理RAW照片，必须先确保软件源可用、依赖完整，再选择适配UOS的安装方式——直接使用apt安装是最稳定可靠的路径，避免手动编译带来的兼容性风险。
确认系统架构与软件源状态
打开终端（Ctrl+Alt+T），执行uname -m确认是amd64还是arm64架构；统信UOS默认启用官方源，但部分版本可能禁用community源，需先检查：sudo apt update && apt list darktable。若提示“无法定位软件包”，说明community源未启用。
执行sudo apt install software-properties-common，然后运行sudo add-apt-repository community启用社区源，再执行sudo apt update刷新包列表。
【必须执行sudo apt update后再安装，否则darktable可能找不到或安装旧版本】
安装Darktable（推荐apt方式）
在终端中输入：sudo apt install darktable，回车后等待自动下载并安装完成。该方式安装的darktable已预编译适配UOS的GTK主题、HiDPI缩放和Wayland会话支持，无需额外配置。
安装完成后，可在启动器中搜索“darktable”直接启动；首次运行时会自动创建~/.config/darktable/配置目录，并弹出数据库初始化向导——点击“确定”即可，无需修改路径。
导入第一批照片
启动darktable后，默认进入“光台（lighttable）”视图。
第一步：点击左上角【导入】→【从文件夹导入】；
第二步：在弹出窗口中，勾选含RAW文件的文件夹（如DCIM/100CANON/），注意不要选中上级空目录；
第三步：右侧“导入选项”中，务必取消勾选【复制到库】——UOS用户应保持原始文件不动，仅建立数据库索引，避免重复占用NVMe磁盘空间；
第四步：点击【导入】，darktable将扫描EXIF与嵌入缩略图，生成轻量级.xmp侧车文件，整个过程不改动原图。
快速验证是否正常工作
导入完成后，在缩略图网格中双击任意一张RAW照片，自动切换至“暗房（darkroom）”界面。
观察右下角状态栏是否显示“OpenCL: enabled”（若显卡驱动已正确安装）；拖动曝光滑块，画布实时响应——说明图像处理引擎已就绪。
按Ctrl+S保存当前编辑状态，darktable会将参数写入同名.xmp文件，原始CR2/ARW/NEF文件毫发无损。
