WordCraft 支持 64 位 Intel/AMD（x86_64）和 ARM64（aarch64）的 Linux，另外还有 RISC-V 版本。不确定选哪种安装包的话，用 AppImage：它在大多数发行版上不用安装就能运行。
开始之前
- 确认架构：运行
uname -m。输出x86_64就用上表的 x86_64 一列，输出aarch64就用 ARM64 一列。 - 需要 glibc 2.35 或更新版本：x86_64 和 ARM64 版本是在 Ubuntu 22.04 上编译的，能在 Ubuntu 22.04、Debian 12 以及更新的发行版上运行。用
ldd --version可以查看 glibc 版本。RISC-V 版本需要 glibc 2.39（Ubuntu 24.04、Debian 13 或更新版本）。 - 国内发行版：deepin、统信 UOS、openKylin 等基于 .deb 的系统，只要 glibc 不低于 2.35，可以试 .deb 或 AppImage。
GitHub 在部分地区下载较慢，可以换个时间再试，或者用支持断点续传的下载工具。不要从网盘或来源不明的“镜像站”下载，下载后按本页最后的方法核对 SHA-256 校验值。
选哪种安装包
| 安装包 | 适合 | 说明 |
|---|---|---|
| AppImage | 任何发行版，或者只想先试试 | 单个文件，不用安装；可以用 AppImageUpdate 自动更新 |
| Flatpak | 已经装了 Flatpak、想要沙盒隔离的用户 | 只能访问“文档”“图片”文件夹和你打开的文件，不能联网 |
| .deb | Debian、Ubuntu、Linux Mint、Pop!_OS 等 | 把 wordcraft 和 wordcraft-cli 安装到 /usr/bin |
| .rpm | Fedora、RHEL、openSUSE | 内容和 .deb 相同 |
| tar.gz 压缩包 | 任何发行版，没有 root 权限时 | 解压后是一个包含 bin/ 和 share/ 的普通文件夹 |
| AUR | Arch Linux | 由社区成员维护，不是 WordCraft 团队发布的 |
安装
下面的命令以 x86_64 文件为例，ARM64 电脑请把文件名里的 x86_64 换成 aarch64。在下载文件所在的文件夹里运行。
AppImage
chmod +x wordcraft-0.7.0-linux-x86_64.AppImage
./wordcraft-0.7.0-linux-x86_64.AppImage
Flatpak
flatpak install --user wordcraft-0.7.0-linux-x86_64.flatpak
flatpak run ai.storyteller.wordcraft
如果还没装 WordCraft 需要的 Freedesktop 运行时，Flatpak 会自动从 Flathub 下载。Flatpak 版通过桌面的文件选择窗口打开文件，所以任何位置的文件都能打开。
Debian、Ubuntu、Linux Mint
sudo apt install ./wordcraft-0.7.0-linux-x86_64.deb
apt 会一并安装依赖的图形库。如果是没有显卡驱动的精简系统，还需要装上发行版的 Mesa 驱动，安装包推荐的是 mesa-vulkan-drivers。
Fedora、RHEL
sudo dnf install ./wordcraft-0.7.0-linux-x86_64.rpm
openSUSE 用 sudo zypper install ./wordcraft-0.7.0-linux-x86_64.rpm。Linux 安装包没有签名，官方只给 Windows 和 Mac 版签名。如果包管理器对此给出警告，请改为核对文件的 SHA-256（见本页最后）。
tar.gz 压缩包
tar xzf wordcraft-0.7.0-linux-x86_64.tar.gz
./wordcraft-0.7.0-linux-x86_64/bin/wordcraft
Arch Linux
yay -S wordcraft-bin
社区成员维护了三个 AUR 包：wordcraft-bin 直接安装官方发布的程序，最快；wordcraft 从源代码编译最新发布版；wordcraft-git 编译当前开发分支。WordCraft 团队自己不往 AUR 发布。
Wayland
在 Wayland 桌面上，只要有 XWayland，WordCraft 就会通过 XWayland 运行，因为它使用的窗口库只在 X11 下支持把文件拖进窗口。想用原生 Wayland（分数缩放时文字更清晰，但不能拖放文件），这样启动：
WORDCRAFT_WAYLAND=1 wordcraft
设置和日志存在哪里
| 内容 | 位置 |
|---|---|
| 设置 | ~/.config/wordcraft（或 $XDG_CONFIG_HOME/wordcraft） |
| 日志文件 | ~/.config/wordcraft/logs/wordcraft.log |
| Flatpak 版 | ~/.var/app/ai.storyteller.wordcraft/config/wordcraft |
反馈问题时附上日志文件，日志里不会记录文档的文字内容。需要更详细的日志时，用 RUST_LOG=debug wordcraft 启动。
卸载
| 安装包 | 方法 |
|---|---|
| AppImage | 删除这个文件 |
| Flatpak | flatpak uninstall --user ai.storyteller.wordcraft |
| .deb | sudo apt remove wordcraft |
| .rpm | sudo dnf remove wordcraft |
| tar.gz | 删除解压出来的文件夹 |
| AUR | sudo pacman -R wordcraft-bin |
设置会留在 ~/.config/wordcraft，不需要的话把这个文件夹也删掉。
更新
- AppImage：用 AppImageUpdate 更新时，它会根据每个版本附带的
.zsync文件只下载有变化的部分。也可以直接下载新的 AppImage，删掉旧的。 - .deb 和 .rpm：用同样的命令安装新版本，会替换旧版本。
- Flatpak：用同样的方法安装新的安装包。如果提示已经安装，先卸载旧版本，设置不会丢。
- AUR：AUR 助手会在更新系统时一起更新它。
遇到问题
除了上面的 Wayland 说明，WordCraft 官方 README 没有列出 Linux 上的启动问题。如果打不开或者显示异常，在终端里用 RUST_LOG=debug 启动，再到 GitHub Issues 反馈，并附上日志文件。
使用前须知
WordCraft 还处于 Alpha 阶段。开发团队估计，它在实际工作中替代 Word 的程度约为 60%；用户遇到的崩溃和卡死，在他们自己列出的不足里排得很靠前。重要文档请留好副本，发给别人之前最好在 Word 或其他软件里检查一遍。
界面可以显示简体中文和繁体中文，默认跟随系统语言，也支持中文输入法；但拼写和语法检查只支持英语，以及系统里装有词典时的波兰语、葡萄牙语、意大利语和克罗地亚语，不检查中文。更多尚未支持的功能，见功能介绍。