在UOS上安装GitKraken需下载官网最新deb包，先手动安装libcurl4、libglib2.0-0等依赖，再用dpkg -i安装并执行sudo apt --fix-broken install修复；启动前须将中文语言文件重命名为en-US.json，首次运行需用绝对路径创建仓库，并禁用GPU加速解决界面错位。
在UOS（统一操作系统）上安装并正常使用GitKraken，需绕过其官方不提供UOS原生支持的限制，通过兼容Debian/Ubuntu的deb包手动安装，并解决依赖缺失、字体渲染异常、中文显示乱码等典型问题。UOS基于Debian，但默认源不含libcurl4、libglib2.0-0等关键运行时库，直接双击安装会静默失败。
下载适配UOS的GitKraken安装包
打开终端，执行：
cd ~/Downloads
wget https://downloads.gitkraken.com/linux/deb/gitkraken-amd64.deb
这一步必须用官网最新deb包，不能用旧版或第三方镜像。UOS 20/22对Electron 23+运行时有兼容性要求，低于v9.10.0的GitKraken版本启动后会白屏卡死。
若wget提示证书错误，加--no-check-certificate参数，但【切勿跳过校验sha256】：执行sha256sum gitkraken-amd64.deb，比对官网发布页公布的哈希值——不一致则立即删除，避免注入风险。
安装前强制补全系统依赖
UOS桌面版默认未预装部分底层库，仅靠dpkg -i会报“unmet dependencies”且不提示具体缺什么。必须提前手动安装：
sudo apt update && sudo apt install -y libcurl4 libglib2.0-0 libxss1 libasound2 libnss3 libatk-bridge2.0-0 libgtk-3-0
其中libglib2.0-0是关键，缺失会导致GitKraken进程启动后立刻退出，日志里只显示“Segmentation fault”，无其他线索。如果系统提示“无法定位软件包”，说明UOS源已过期，需先执行sudo apt-add-repository main && sudo apt update。
安装GitKraken并修复中文乱码
方法一：命令行安装（推荐）
sudo dpkg -i gitkraken-amd64.deb → 若报依赖错误，立刻执行sudo apt --fix-broken install，它会自动补全剩余依赖并完成配置。
方法二：图形界面安装
右键deb包→“使用应用商店安装”，但UOS应用商店会拦截非签名包——此时点击“仍要安装”，弹窗确认后等待进度条走完。
安装完成后，首次启动前必须替换语言资源。执行：
mkdir -p ~/.gitkraken/locales
cd ~/.gitkraken/locales
wget https://raw.githubusercontent.com/k-skye/gitkraken-chinese/master/zh-CN.json
mv zh-CN.json en-US.json
【注意：文件名必须是en-US.json，不是zh-CN.json】 GitKraken硬编码读取en-US.json作为主语言文件，改名才能生效。否则界面仍是英文，且设置里找不到语言选项。
启动与基础配置
第一步：在应用启动器搜索“GitKraken”，点击图标启动。
第二步：首次运行会弹出许可协议，勾选“I agree”后点Continue。
第三步：登录GitHub/GitLab账户，或选择“Skip for now”跳过——跳过不影响本地仓库操作，但无法同步远程分支状态。
第四步：创建新仓库时，点击左上角File→New Repository，路径必须为绝对路径（如/home/user/project），相对路径会导致后续所有提交按钮置灰不可用。
启动后若界面元素错位或文字重叠，是UOS默认Qt主题与Electron冲突所致。立即执行：gitkraken --disable-gpu，然后在设置→Preferences→Appearance里关闭“Hardware Acceleration”。
