Windows 下 Gram 编辑器折腾记录

Open Table of contents

前言
Gram
操作环境
安装 Astro、Typst 等 Extension
- 坑 1 、Rust 环境缺少 wasm32-wasip2 编译目标
- 坑 2 、wasi-sdk 下载问题

前言

Stop coding in browser.

闲暇之余，随手折腾一下。

Gram

官网：Gram

Source：codeberg.org/GramEditor/gram

操作环境

Windows 11 24H2
Gram v3.0.1

安装 Astro、Typst 等 Extension

坑 1 、Rust 环境缺少 `wasm32-wasip2` 编译目标

在我安装时国内镜像源不含该组件包，遂报错，故临时切回官方源。

在 Windows 系统环境变量中删除 RUSTUP_DIST_SERVER 。

重新打开 Powershell 运行：

rustup target add wasm32-wasip2

检查：

rustup target list --installed

确认输出里有 wasm32-wasip2 。

提示：如果在删除相关环境变量与 settings.toml 中下载源配置后仍然报错，且错误信息中含有已经删除的下载源，请运行 rustup update 并再次尝试安装。

坑 2 、wasi-sdk 下载问题

解决坑 1 后继续尝试安装 Extension，完成仓库克隆后一直处于 Installing extension 转圈状态，等待许久，未能解决，查询日志：

grammar 编译阶段时，Gram 需要下载 wasi-sdk：

11:45:14 INFO  compiling grammar astro for extension ...
11:45:14 INFO  downloading wasi-sdk to C:\Users\User\AppData\Local\Gram\extensions\build\wasi-sdk

随后超时失败（Github 连接不稳定；即使稳定，下载 496 MB 的文件也需要一定时间）：

11:45:14 ERROR failed to compile grammar 'astro'
Caused by:
    0: error sending request for url (...wasi-sdk-25.0-x86_64-windows.tar.gz...)
    1: client error (Connect)
    2: operation timed out

得知，Gram 需要 wasi-sdk 进行编译，故自行手动下载 wasi-sdk：

手动下载 wasi-sdk 25.0 Windows 版（即日志中下载失败的版本，也可以尝试使用最新稳定版，详见 Releases ）：WebAssembly/wasi-sdk/releases/tag/wasi-sdk-25

下载 wasi-sdk-25.0-x86_64-windows.tar.gz 文件，解压到 Gram 指定目录（如不存在，自行新建）:

C:\Users\Username（替换用户名）\AppData\Local\Gram\extensions\build\wasi-sdk

解压后该目录下应该有 bin、lib、share 等文件夹。

重启 Gram ，再次尝试安装扩展。此时 Gram 检测到 wasi-sdk 已存在，便会跳过下载，直接进入编译。

顷刻，安装完成。