统信UOS安装Gnome Builder有两种方式：一、APT安装，执行sudo apt update && sudo apt install gnome-builder，自动安装builder本体及libide等依赖；二、Flatpak安装，先启用Flatpak并添加Flathub源，再运行flatpak install flathub org.gnome.Builder，并需执行flatpak override --user --filesystem=home授权访问宿主文件。
统信UOS安装Gnome Builder的两种方式
在统信UOS上安装Gnome Builder需绕过软件中心默认不提供该IDE的问题，必须通过命令行启用源或使用Flatpak渠道——因为Builder是GNOME官方开发工具，未被UOS预装且不在main仓库中。
方法一：APT安装（推荐，支持系统集成与调试符号）
打开终端，先执行sudo apt update确保源列表最新；再运行sudo apt install gnome-builder。这会自动拉取builder本体、libide核心库、gnome-desktop3-dev等依赖——缺少libide会导致启动后新建项目失败，界面卡在“Loading Projects”。
方法二：Flatpak安装（沙箱隔离，但需手动授权访问宿主文件）
先确认Flatpak已启用：终端执行flatpak --version，若报错则先运行sudo apt install flatpak && sudo flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo；再执行flatpak install flathub org.gnome.Builder。注意：首次启动时会提示“Permission denied”无法读取~/Projects目录，此时必须在终端运行flatpak override --user --filesystem=home org.gnome.Builder授权，否则所有项目保存操作均失败。
首次启动前的关键配置
启动Gnome Builder前必须完成三项初始化设置，否则新建C项目时编译直接报错。
第一步：启用系统级构建工具链
终端执行sudo apt install build-essential libgtk-4-dev libadwaita-1-dev。其中libadwaita-1-dev是UOS 23+桌面环境必需的UI组件头文件，缺失将导致Builder生成的模板项目无法通过meson configure阶段。
第二步：配置Git用户信息（强制要求）
在终端依次运行：
git config --global user.name "YourName"
git config --global user.email "you@example.com"
Builder在创建新项目时会调用git init，若未设user.name，项目初始化会中断并弹出红色错误提示框，无法继续。
第三步：验证GNOME SDK版本兼容性
终端输入flatpak list | grep org.gnome.Sdk，确认输出包含org.gnome.Sdk/x86_64/45或更高版本。UOS 23默认搭载GNOME 45，若显示43或更低，需手动更新：执行flatpak update org.gnome.Sdk。使用低版本SDK会导致Builder中“Run”按钮灰显，因新API（如GtkToast）不可用。
创建第一个GTK应用并运行
这一步操作起来很简单，直接点击左上角“New”→选择“GTK Application”模板即可，但有三个关键点必须同步操作。
① 在项目名称输入框填入纯英文名（如hello-world），禁止含空格或中文——Builder底层用作路径拼接，出现空格会导致meson.build解析失败，报错“Invalid character in project name”。
② 点击“Create”后，等待右下角状态栏显示“Project configured”（约8秒），此时不要立即点Run。必须先点击顶部菜单栏“Build”→“Configure Build Options”，在弹窗中将“Build Type”从“Debug”改为“Release”，否则首次运行会因调试符号加载超时而卡死在黑屏。
③ 点击绿色三角形“Run”按钮，Builder会自动启动内置终端并执行cargo run（若选Rust模板）或meson compile（C模板）。窗口标题栏显示“Hello World”即表示成功——此时可关闭窗口，Builder会自动保存运行记录到左侧“Run”面板。
