从零开始掌握 Xournal++

1. 安装与首次启动

Xournal++ 支持 Windows、macOS 和 Linux 三大桌面平台，安装过程与普通桌面软件无异。下面分别介绍各平台的安装要点。

Windows 安装

推荐使用 MSIX 安装包，它运行在沙箱环境中，支持自动更新，且不会污染系统注册表。下载完成后双击 .msix 文件，按提示完成安装即可。如遇系统提示需要开发者许可证，可在 PowerShell 中执行：

add-appxpackage xournalpp-1.x.x-windows.msix

对于 Windows 7 或不希望使用 MSIX 的用户，可下载便携版 .zip，解压后直接运行 xournalpp.exe，无需任何安装步骤，非常适合放入 U 盘随身携带。

macOS 安装

macOS 用户请根据芯片类型选择对应的 DMG 镜像：M1/M2/M3 系列芯片选择 Apple Silicon 版本，Intel 芯片选择 Intel 版本。下载 DMG 后双击挂载，将 Xournal++ 拖入 Applications 文件夹即完成安装。

首次启动时 macOS 可能提示"无法验证开发者"。这是正常的——Xournal++ 完全开源免费，没有购买 Apple 开发者证书。前往 系统偏好设置 → 安全性与隐私，点击"仍要打开"即可。

若使用 Homebrew，也可一键安装：brew install --cask xournalplusplus。

Linux 安装

Linux 各发行版安装方式略有不同。推荐使用 AppImage 通用包，下载后赋予执行权限即可运行：

chmod +x xournalpp-1.x.x-x86_64.AppImage
./xournalpp-1.x.x-x86_64.AppImage

各大发行版也都收录了 Xournal++：

• Debian / Ubuntu：sudo apt install xournalpp
• Fedora：sudo dnf install xournalpp
• Arch Linux (AUR)：yay -S xournalpp
• Flatpak：flatpak install flathub com.github.xournalpp.xournalpp
• Snap：sudo snap install xournalpp

提示：发行版仓库中的版本可能落后于 GitHub 最新发布。若需要最新功能，建议从 GitHub Releases 下载 AppImage 或源码编译。

2. 创建第一份笔记

启动 Xournal++ 后，会自动创建一个空白笔记本，默认包含 1 页 A4 横线背景。你可以立即开始用鼠标或数位笔书写。

左侧工具栏从上到下依次是：

• 选择工具：框选或套索选择已绘制的笔迹
• 笔：核心书写工具，支持压感
• 荧光笔：半透明笔触，适合标注重点
• 橡皮擦：可按笔画或按区域擦除
• 文字：插入文本框
• 形状：直线、箭头、矩形、椭圆等
• 图片：插入 PNG/JPG/SVG

顶部右侧有"页面"按钮，可添加新页面。底部状态栏显示当前缩放比例、坐标和当前页面/总页数。

3. 笔触与压感配置

这是获得"接近纸笔"体验的关键一步。点击菜单 编辑 → 首选项，切换到"笔触输入"标签页。

压感校准

如果你的数位板支持压感（绝大多数 Wacom、Huion 现代型号都支持），勾选"启用压感"复选框。Xournal++ 会自动检测设备能力。若压感不灵敏，可调整下方的"压感曲线"——横轴是物理压力，纵轴是输出粗细。S 型曲线适合大多数书写场景。

笔触平滑

压感书写的笔迹往往带有手部抖动。"笔触平滑"参数会让线条变得更顺滑，但过高的平滑度会让快速书写产生延迟。建议从默认值 0.5 开始，根据个人习惯微调。

多笔配置

Xournal++ 支持为不同的笔触类型（钢笔、马克笔、荧光笔）分别配置颜色、粗细、压感曲线。每种笔型都可在工具栏快速切换，无需每次重新设置。

4. PDF 批注工作流

这是 Xournal++ 最被高频使用的场景。完整工作流如下：

1. 导入 PDF：菜单 文件 → 打开，或直接拖拽 PDF 文件到窗口。Xournal++ 会以 PDF 每一页为背景创建对应数量的笔记页面。
2. 开始批注：选择任意笔型，直接在 PDF 页面上书写。批注会保存在独立的图层中，不会修改原始 PDF。
3. 使用荧光笔：荧光笔自动应用"乘法混合"模式，下方的文字依然清晰可读，非常适合标注重点段落。
4. 添加书签：在重要页面按 Ctrl+B 添加书签，便于后续快速跳转。
5. 保存为 .xopp：批注完成后保存为 Xournal++ 原生格式 .xopp，可随时回溯修改。
6. 导出 PDF：菜单 文件 → 导出为 PDF，会生成包含原始内容与批注的合并 PDF。

提示：.xopp 文件本质上是一个 ZIP 压缩包，包含 XML 笔记数据与原始 PDF。备份时直接复制 .xopp 文件即可，无需额外保存原始 PDF。

5. 多图层管理

图层是 Xournal++ 区别于普通笔记本应用的核心特性之一。点击左侧"图层"侧栏（如未显示，菜单 视图 → 侧边栏 → 图层），可以看到当前页面的所有图层。

典型用法

• PDF 批注场景：底层为原始 PDF，上层为"我的批注"，再上层为"待办事项"。复习时可隐藏批注层，只看原文测试理解。
• 课堂笔记场景：第 1 层为老师课件内容速记，第 2 层为自己的疑问与思考，第 3 层为下课后整理的总结。
• 设计草稿场景：底层为参考图，顶层为设计稿，可独立导出顶层作为最终交付。

常用操作

• 双击图层名重命名
• 点击眼睛图标显示/隐藏
• 点击锁图标防止误操作
• 右键菜单可复制、合并、清空图层

6. LaTeX 公式插入

Xournal++ 内置 LaTeX 渲染引擎（基于 Poppler 库），无需联网即可渲染数学公式。要使用此功能，请确保系统已安装 LaTeX 发行版：

• Windows：安装 MiKTeX 或 TeX Live
• macOS：安装 MacTeX
• Linux：安装 texlive（sudo apt install texlive）

使用方法：

1. 菜单 工具 → LaTeX 公式，或按快捷键 Ctrl+Shift+L。
2. 在弹出的对话框中输入 LaTeX 源码，例如：\int_a^b f(x) dx = F(b) - F(a)
3. 点击"预览"查看渲染效果。
4. 确认无误后点击"插入"，公式以矢量图形形式插入到当前位置。

已插入的公式可双击重新编辑，修改后实时重新渲染。

7. 音频同步笔记

这是 Xournal++ 最被低估的功能之一。开启录音后，每一笔书写都会被自动打上时间戳，回放时点击笔迹即可跳转到对应录音时刻。非常适合：

• 课堂讲座：边听边记，复习时点击笔迹跳转录音
• 会议纪要：边讨论边记录要点，会后定位关键决策
• 采访记录：边问边速记，整理时还原完整对话

使用步骤

1. 点击工具栏的红色圆点按钮，或菜单 音频 → 开始录音。
2. 正常书写笔记，每一笔都会自动绑定时间戳。
3. 结束时点击停止按钮，录音文件会自动保存到笔记所在目录。
4. 回放时点击任意笔迹，音频会从对应时刻开始播放。

录音默认保存为 MP3 格式。如需更换格式，可在 编辑 → 首选项 → 音频 中设置。

8. 快捷键速查

熟练使用快捷键是高效笔记的关键。下表列出最常用的快捷键（Windows/Linux 使用 Ctrl，macOS 使用 Cmd）：

9. 插件使用与开发

Xournal++ 内置 Lua 5.4 脚本引擎，所有插件都是 Lua 脚本。使用插件无需编程基础，开发插件则需要了解 Lua 基础语法。

使用社区插件

1. 菜单 插件 → 插件管理器。
2. 浏览社区插件列表，点击"安装"。
3. 插件会自动下载到 ~/.xournalpp/plugins/ 目录。
4. 重启 Xournal++ 后插件生效。

开发你的第一个插件

插件由一个 plugin.ini 元数据文件和若干 Lua 脚本组成。最简单的 "Hello World" 插件结构如下：

-- plugin.ini
[plugin]
name=HelloWorld
description=My first Xournal++ plugin
author=Your Name
version=1.0

-- main.lua
function on_init()
    app.register_ui({
        menu_item = "Say Hello",
        callback = "on_say_hello"
    })
end

function on_say_hello()
    app.dialog_message("Hello from Xournal++ plugin!")
end

把这个目录放到 ~/.xournalpp/plugins/hello/ 下，重启 Xournal++ 即可在菜单中看到 "Say Hello" 项。完整 API 文档请访问 官方 Wiki 插件页面。

10. 导出与分享

Xournal++ 支持三种导出格式：

• PDF (.pdf)：批注与原始内容合并，矢量输出，适合打印与分享。
• SVG (.svg)：矢量图形，可被 Inkscape、Illustrator 等工具进一步编辑。
• PNG (.png)：位图输出，可设置 DPI 与背景透明度。

导出时可以选择"当前页"或"全部页面"。批量导出时，PDF 是单文件，SVG 和 PNG 是每页一个文件。

11. 常见问题 FAQ