Laverna桌面版安装指南：Windows、macOS与Linux全平台教程

Laverna是一款支持Markdown编辑和加密功能的开源笔记应用，可作为Evernote的替代方案。本文将详细介绍在Windows、macOS和Linux系统上安装Laverna桌面版的完整步骤，帮助用户快速部署这款安全的笔记工具。

安装前准备

Laverna桌面版基于Electron框架开发，支持跨平台运行。安装前需确认：

• 系统版本：Windows 7+、macOS 10.9+ 或 Linux (Ubuntu 14.04+, Fedora 21+, Debian 8+)
• 硬件要求：至少1GB RAM和50MB可用磁盘空间
• 网络连接：用于下载安装包和依赖项

项目核心Electron配置文件：electron.js、gulps/electron.js

Windows系统安装步骤

1. 下载安装包

从官方发布页面获取Windows版压缩包，包含32位和64位版本。

2. 解压与安装

1. 右键解压下载的ZIP文件至目标文件夹（如C:\Program Files\Laverna）
2. 双击运行laverna.exe启动程序
3. 首次运行会显示安全提示，点击"更多信息"→"仍要运行"

3. 创建桌面快捷方式

右键laverna.exe→发送到→桌面快捷方式，方便快速访问。

macOS系统安装步骤

1. 下载与解压

下载macOS版DMG文件，双击挂载后将Laverna拖入应用程序文件夹。

2. 解决安全限制

macOS可能阻止未签名应用运行：

1. 右键应用→按住Option键→选择"打开"
2. 在弹出窗口中点击"打开"确认

3. 消除网络警告（可选）

若频繁出现网络连接提示，可通过终端签名应用：

codesign -s - -f /Applications/Laverna.app/Contents/Frameworks/Electron\ Framework.framework
codesign -s - -f /Applications/Laverna.app/Contents/Frameworks/Electron\ Helper.app

Linux系统安装方法

方法1：二进制包安装（推荐）

1. 下载Linux版tar.gz包并解压：

   tar -zxvf laverna-linux-x64.tar.gz -C ~/Applications
   

2. 创建启动器：

   ln -s ~/Applications/laverna/laverna ~/.local/bin/laverna
   

方法2：Arch Linux AUR安装

Arch用户可通过AUR安装：

pacaur -S laverna  # 使用pacaur或其他AUR助手

方法3：源码编译安装

1. 克隆仓库：

   git clone https://gitcode.com/gh_mirrors/la/laverna.git
   cd laverna
   

2. 安装依赖并构建：

   npm install
   bower install
   gulp build
   gulp electron  # 生成Linux可执行文件
   

构建配置文件：gulpfile.js（第16行和62行定义Electron构建任务）

从源码构建桌面版（高级用户）

1. 环境准备

安装必要工具链：

# Ubuntu/Debian
sudo apt install git nodejs npm
# macOS (使用Homebrew)
brew install git node

2. 获取源码

git clone https://gitcode.com/gh_mirrors/la/laverna.git
cd laverna

3. 安装依赖

npm install -g gulp bower
npm install
bower install

4. 构建桌面应用

gulp electron  # 生成对应平台的应用包

构建产物位于dist/electron目录，包含各平台可执行文件。

常见问题解决

启动失败

• 检查Node.js版本（需v8.0+）：node -v
• 删除配置目录后重试：
  • Windows: %APPDATA%\Laverna
  • macOS: ~/Library/Application Support/Laverna
  • Linux: ~/.config/Laverna

中文显示异常

修改配置文件app/locales/zh_cn/translation.json，确保编码为UTF-8。

官方本地化文件：app/locales/

卸载方法

• Windows：直接删除安装目录并清理快捷方式
• macOS：将应用拖入废纸篓，删除~/Library/Application Support/Laverna
• Linux：删除安装目录和~/.config/Laverna配置文件夹

相关资源

• 用户手册：app/docs/howto.md
• 加密模块源码：app/scripts/classes/encryption.js
• 构建脚本：gulpfile.js
• 官方文档：README.md

通过以上步骤，用户可在各主流操作系统上完成Laverna桌面版的安装与配置。如需自定义构建或解决特定问题，可查阅项目构建脚本和源码文件获取更多技术细节。