Debian（ARM平台）编译 MarkText 指南

原创已于 2025-07-23 19:00:07 修改 · 245 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#debian #arm开发

于 2025-07-23 18:41:04 首次发布

1. 下载安装 Node.js 16.20.2 (ARM64)

为兼容该项目，系统将使用 Node.js 16.20.2

(1) 下载并解压包

wget https://nodejs.org/dist/v16.20.2/node-v16.20.2-linux-arm64.tar.gz
tar -xvf node-v16.20.2-linux-arm64.tar.gz

(2) 移动到系统目录

mkdir -p /usr/local/nodejs
sudo mv node-v16.20.2-linux-arm64 /usr/local/nodejs

(3) 创建软链接

sudo ln -sf /usr/local/nodejs/bin/node /usr/local/bin/node
sudo ln -sf /usr/local/nodejs/bin/npm /usr/local/bin/npm
sudo ln -sf /usr/local/nodejs/bin/npx /usr/local/bin/npx

(4)验证安装

node -v  # 应输出 v16.20.2
npm -v   # 应输出 8.19.4

(5) 修复环境变量（可选）

如果命令仍不可用，将 Node.js 路径加入 PATH：
编辑 ~/.bashrc 或 ~/.zshrc

echo 'export PATH=/usr/local/nodejs/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

2.手动安装 fpm（ARM64 兼容）

electron-builder 下载的 fpm 工具是 x86 版本；官方可能未提供 ARM64 版本的 fpm

# 安装 Ruby 和 fpm 依赖
sudo apt update
sudo apt install -y ruby ruby-dev build-essential

# 安装 fpm
sudo gem install fpm

3.安装其它依赖

sudo apt update
sudo apt install -y git yarnpkg python3 make g++ libx11-dev libxkbfile-dev libsecret-1-dev libgtk-3-dev libwebkit2gtk-4.0-dev

4. 克隆源码

# 克隆项目(GitCode镜像)
git clone https://gitcode.com/markdownotes/marktext.git

# 进入项目文件夹
cd marktext

5. 安装 Node.js 依赖

# Yarn换国内源（腾讯云）
yarn config set registry https://mirrors.cloud.tencent.com/npm/

# 安装 Node.js 依赖
yarn install

6.手动下载 electron-v18.0.4（ARM64）

electron-builder 无法下载 Electron 的 ARM64 二进制包。主要原因是：

网络连接问题：访问 GitHub 下载可能受限（特别是国内用户）
Electron 镜像问题：默认镜像可能无法访问

wget https://npmmirror.com/mirrors/electron/v18.0.4/electron-v18.0.4-linux-arm64.zip
mkdir -p ~/.cache/electron
mv electron-v18.0.4-linux-arm64.zip ~/.cache/electron/

7. 编译 MarkText（ARM64）

# 设置环境变量
export USE_SYSTEM_FPM=true

# 运行构建命令
yarn run build --linux --arm64 --config.linux.target=deb

8. 安装运行

sudo apt install ./build/marktext-arm64.deb