desigma安装教程:macOS/Windows/Linux三平台快速上手指南(附首次启动避坑)
desigma安装教程:macOS/Windows/Linux三平台快速上手指南(附首次启动避坑)
desigma 是一款用 Rust 编写的免费开源界面设计工具,作为 Figma 的替代品,支持组件、自动布局、原型、实时协作等核心功能,完全离线可用。本文是一份完整的 desigma 安装教程,覆盖 macOS、Windows、Linux 三大平台,并详解首次启动时最常见的系统警告问题及解决方法。
一、安装前:了解 desigma 是什么
在动手安装之前,先快速了解一下你即将得到什么。desigma 是一个本地优先(local-first)的桌面设计工具,主要能力包括:
- 🎛️ 熟悉的设计工作流:Frame、自动布局(Auto Layout)、组件与变体、原型交互
- 👥 实时协作:分享链接即可多人同屏编辑,端到端加密、无需账号
- 🎬 关键帧动效:时间轴、缓动曲线、41 个动画预设,可导出 GIF/WebM
- 🗂️ Figma 文件导入:直接打开
.fig文件,保留组件、样式与原型链接 - ⚡ 原生性能:纯 Rust 实现,无 Electron、无 WebView,5000 图层页面依然流畅
安装完成后,你会看到这样的项目主页(本地文件库,支持最近项目、收藏、网格/列表视图):
📌 版本说明:desigma 目前处于 early alpha 阶段,功能大体可用但仍有待打磨,建议遇到问题时记录截图与系统信息。
二、下载 desigma 安装包
前往项目仓库的 最新 Release 页面,根据你的系统选择对应的文件:
| 平台 | 文件 | 说明 |
|---|---|---|
| macOS(Apple Silicon 与 Intel 通用) | desigma-<版本>-macos.dmg |
一个文件通吃两种芯片 |
| Windows(x64) | desigma-<版本>-x86_64-windows-setup.exe |
安装器,推荐 |
| Windows(x64)便携版 | desigma-<版本>-x86_64-pc-windows-msvc.zip |
免安装,解压即用 |
| Linux(x64) | desigma-<版本>-x86_64-unknown-linux-gnu.tar.gz |
压缩包内含一键安装脚本 |
| macOS 脚本/CLI 用 | desigma-<版本>-macos-universal.tar.gz |
自动化场景使用 |
Release 页面同时提供 SHA256SUMS 校验文件,下载后可验证完整性:
sha256sum -c SHA256SUMS --ignore-missing # Linux
shasum -a 256 -c SHA256SUMS --ignore-missing # macOS
详细平台对照请参考官方安装文档:docs/install.md。
三、macOS 安装步骤(含 Gatekeeper 警告处理)
macOS 11 及以上版本均可运行,步骤如下:
- 双击下载的
.dmg文件打开磁盘映像; - 将 desigma 拖入 Applications(应用程序)快捷方式;
- 打开"应用程序"文件夹,双击 desigma 启动(此时可弹出磁盘映像);
- 首次启动警告:macOS 会提示"无法验证 desigma 是否含有恶意软件",点击 完成(Done);
- 打开 系统设置 → 隐私与安全性,向下滚动找到"desigma 已被阻止"的提示,点击 仍要打开(Open Anyway);
- 用密码或 Touch ID 确认,再点最后的 打开 按钮。
# 喜欢终端的同学可用这一行命令代替上面第 5、6 步:
xattr -dr com.apple.quarantine /Applications/desigma.app
这一步只需做一次,之后 desigma 像普通 App 一样直接打开。原因是发布版本尚未完成 Apple 公证(notarization),并非软件本身有问题——源码公开,每个版本都由 CI 从打标签的提交构建。
💡 小贴士:.desigma 和 .fig 文件在 Finder 的"打开方式"中会列出 desigma。目前双击文件尚不能直接交给已运行的 desigma,可用 文件 → 打开、拖拽文件到窗口,或在终端运行:
/Applications/desigma.app/Contents/MacOS/desigma 路径/to/file.desigma
四、Windows 安装步骤(SmartScreen 与 Defender 避坑)
方式一:安装器(推荐)
- 下载
desigma-<版本>-x86_64-windows-setup.exe,双击运行; - SmartScreen 拦截:弹窗显示"Windows 已保护你的电脑",点击 更多信息(More info),再点击 仍要运行(Run anyway);
- 跟随安装向导。默认仅安装给当前用户(
%LOCALAPPDATA%\Programs\desigma),全程无需管理员权限;如需装到C:\Program Files\desigma供所有用户使用,在向导中选择"为所有用户安装"; - 按需勾选 创建桌面快捷方式、用 desigma 打开 .desigma 文件,保持 启动 desigma 勾选即可立即体验。
后续升级直接运行新版安装器即可就地更新;卸载走 设置 → 应用 → 安装的应用 → desigma → 卸载,你的设计文件不会被触碰。
方式二:便携版
解压 zip 到任意位置,双击 desigma.exe 即可运行,SmartScreen 处理同上;删除整个文件夹即完成卸载。
🚨 避坑:Windows Defender 误隔离
未签名的构建偶尔会被 Defender 误报。如果下载文件或 exe 被隔离,打开 Windows 安全中心 → 病毒和威胁防护 → 保护历史记录,恢复该项目并选择 允许在此设备上,再用 certutil -hashfile <文件> SHA256 对照 SHA256SUMS 校验后即可放心运行。
五、Linux 安装步骤
Linux 上没有任何系统警告,流程最干净:
# 1. 解压并直接运行
tar -xzf desigma-<版本>-x86_64-unknown-linux-gnu.tar.gz
cd desigma-<版本>-x86_64-unknown-linux-gnu
./desigma
推荐:运行包内附带的一键安装脚本,它会以当前用户身份把二进制、.desktop 菜单项、图标和文件类型装到 ~/.local 下,无需 sudo(安装逻辑见 packaging/linux/install.sh):
./install.sh
🚨 避坑:最小化系统缺少图形库
在 Debian / Ubuntu 等发行版上,精简安装的系统可能缺少编辑器依赖的库,可手动补齐:
sudo apt install libxkbcommon0 libwayland-client0 libx11-6 libxcursor1 libxrandr2 libxi6 libgl1 libfontconfig1
普通桌面环境一般都已自带这些库,装完解压即用。
六、首次启动后的三件小事
1. 认识主界面
首次启动会加载内置演示文档,画布、图层、右侧检查器一目了然:
常用快捷键与 Figma 一脉相承:F 建 Frame、Shift+A 打开自动布局、Ctrl+K 唤起命令面板、Ctrl+Alt+K 把图层转为组件。
2. GPU 渲染异常怎么办
画布默认使用 GPU 渲染(Vulkan / Metal / DirectX 12 / OpenGL),找不到合适的显卡适配器时会自动回退到 CPU 渲染器。如果看到绘制异常,进入 偏好设置 → 关闭 Use GPU rendering 即可恢复正常。
3. 自动更新机制
desigma 启动数秒后(之后每天一次)会静默检查是否有新版本。发现新版后会显示横幅,点击 立即更新 才真正下载,并自动校验 SHA-256;更新完成后 重启以更新。若不想自动检查,可在 偏好设置 → Check for updates automatically 中关闭,或设置环境变量 DESIGMA_NO_UPDATE_CHECK=1;帮助 → 检查更新 随时可用。
七、进阶:从源码构建 desigma
想参与开发或尝鲜最新代码?安装 Rust 后执行:
git clone https://gitcode.com/gh_mirrors/de/desigma
cd desigma
cargo run --release -p desigma-app
项目通过 rust-toolchain.toml 锁定了 Rust 1.93.1 工具链,rustup 会自动安装对应版本,无需手动配置。Linux 构建需额外安装窗口系统头文件(如 libxkbcommon-dev、libwayland-dev 等),更多细节见 CONTRIBUTING.md。
八、常见问题速查(FAQ)
| 问题 | 解决方法 |
|---|---|
| macOS 提示"无法验证开发者" | 系统设置 → 隐私与安全性 → 仍要打开;或执行 xattr -dr com.apple.quarantine /Applications/desigma.app |
| Windows 弹窗"已保护你的电脑" | 点 更多信息 → 仍要运行(未签名构建的一次性提示) |
| exe 被 Defender 隔离 | 保护历史记录中恢复并"允许在此设备",校验 SHA-256 后运行 |
| Linux 启动闪退 | 大概率缺图形库,参考第五节 apt install 命令 |
| 画布渲染异常 | 偏好设置中关闭 Use GPU rendering |
| 想关掉更新检查 | 偏好设置关闭,或设 DESIGMA_NO_UPDATE_CHECK=1 |
| 卸载 | Windows 走系统"卸载";macOS 拖出应用程序;Linux 删 ~/.local 下相关文件 |
至此,desigma 安装教程全部完成。总结一下关键点:macOS 拖入应用程序 + 一次"仍要打开";Windows 双击安装器 + 一次"仍要运行";Linux 解压 + ./install.sh。三个平台的警告都只源于发布版暂未代码签名,属于一次性操作,之后一切如常。打开软件,新建一个 Frame,开始你的设计吧 🚀


