手写笔记神器 Xournal++：Linux 系统从源码到应用的完整指南

手写笔记神器 Xournal++：Linux 系统从源码到应用的完整指南

【免费下载链接】xournalppXournal++ is a handwriting notetaking software with PDF annotation support. Written in C++ with GTK3, supporting Linux (e.g. Ubuntu, Debian, Arch, SUSE), macOS and Windows 10. Supports pen input from devices such as Wacom Tablets.项目地址: https://gitcode.com/gh_mirrors/xo/xournalpp

还在为找不到好用的手写笔记软件而烦恼吗？Xournal++ 作为一款功能强大的开源手写笔记工具，支持 PDF 注释、LaTeX 公式、音频录制等丰富功能，让您的数字笔记体验更加完美。本文将手把手教您在 Linux 系统上从源码编译到成功运行 Xournal++ 的全过程。✨

为什么选择 Xournal++？

Xournal++ 是一款专为手写笔记设计的跨平台应用，具有以下核心优势：

• PDF 注释功能：直接在 PDF 文档上进行标记和批注
• LaTeX 支持：轻松插入数学公式和专业符号
• 插件系统：通过 Lua 脚本扩展功能
• 音频集成：支持录音并与笔记时间轴同步

Xournal++ 提供了直观的用户界面，工具栏和侧边栏布局合理，便于快速访问各种功能

准备工作：环境与依赖

系统环境检查

在开始编译之前，请确保您的系统满足以下基本要求：

编译器要求：

• GCC 8.0+ 或 Clang 9.0+
• 完整支持 C++17 标准
• 文件系统库（STL 或 Boost）

构建工具：

• CMake 3.13+（推荐 3.15+）
• make 或 ninja 构建系统

一键安装依赖包

根据您的 Linux 发行版，选择合适的命令安装所有必要依赖：

Ubuntu/Debian 系列：

sudo apt update && sudo apt install cmake libgtk-3-dev libpoppler-glib-dev \ portaudio19-dev libsndfile-dev dvipng texlive libxml2-dev \ liblua5.3-dev libzip-dev librsvg2-dev gettext \ lua-lgi libgtksourceview-4-dev help2man

Fedora/RHEL/CentOS：

sudo dnf install gcc-c++ cmake gtk3-devel libxml2-devel \ portaudio-devel libsndfile-devel poppler-glib-devel \ texlive-scheme-basic texlive-dvipng gettext libzip-devel \ librsvg2-devel lua-devel lua-lgi gtksourceview4-devel help2man

Arch Linux：

sudo pacman -S cmake gtk3 base-devel libxml2 portaudio \ libsndfile poppler-glib texlive-bin texlive-pictures \ gettext libzip lua53 lua53-lgi gtksourceview4 help2man

获取源码与编译步骤

1. 下载源码

首先从官方镜像仓库获取最新源码：

git clone https://gitcode.com/gh_mirrors/xo/xournalpp cd xournalpp

2. 配置编译环境

创建独立的构建目录，避免污染源码：

mkdir build && cd build

运行 CMake 配置项目：

cmake ..

3. 开始编译

使用以下命令开始编译过程：

cmake --build . -j$(nproc)

-j$(nproc)参数会自动检测您的 CPU 核心数，实现并行编译以加快速度。

Xournal++ 的图层管理功能让您能够轻松组织复杂的笔记内容

安装与配置

系统级安装

如果您希望所有用户都能使用 Xournal++：

sudo cmake --build . --target install

用户级安装（推荐）

仅安装到当前用户目录，避免权限问题：

cmake .. -DCMAKE_INSTALL_PREFIX="$HOME/.local" cmake --build . --target install

运行配置脚本

安装完成后，运行配置脚本确保所有文件关联正确：

./cmake/postinst configure

功能特性深度体验

强大的工具栏系统

Xournal++ 提供了高度可定制的工具栏，您可以根据使用习惯调整工具布局。

丰富的工具栏选项，包括画笔、橡皮擦、选择工具等

浮动工具箱

对于频繁使用的工具，可以启用浮动工具箱：

浮动工具箱让您在任何位置都能快速访问常用功能

几何工具支持

项目中的几何工具模块为工程绘图提供了专业支持：

# 相关源码路径 src/core/control/CompassController.cpp src/core/control/SetsquareController.cpp src/core/model/Compass.cpp src/core/model/Setsquare.cpp

常见问题与解决方案

编译失败怎么办？

问题：CMake 配置时提示缺少依赖解决：仔细检查错误信息，确保所有开发包都已正确安装。特别注意以-dev或-devel结尾的包。

插件无法加载？

问题：Lua 插件显示为不可用解决：确认已安装 Lua 5.3 和 lua-lgi

PDF 注释功能异常？

问题：无法在 PDF 上添加注释解决：检查 poppler-glib 开发包是否正确安装

进阶使用技巧

自定义页面模板

您可以在resources-templates/pagetemplates.ini.in文件中定义个性化的页面模板，满足不同场景的需求。

快捷键配置

Xournal++ 支持自定义快捷键，通过修改配置文件可以极大提升操作效率。

版本更新与维护

获取最新版本

定期从源码仓库拉取更新：

cd xournalpp git pull origin master

重新编译

当有重大更新时，建议清理旧的构建目录重新编译：

rm -rf build mkdir build && cd build cmake .. cmake --build . -j$(nproc)

丰富的背景模板选择，满足从横线纸到五线谱的各种需求

打包与分发

创建 DEB 包（Ubuntu/Debian）

cmake .. -DCPACK_GENERATOR="DEB" cmake --build . --target package

生成 AppImage

使用项目提供的脚本创建便携式 AppImage：

./linux-setup/build_appimage.sh

结语

通过本文的详细指导，您应该已经成功在 Linux 系统上编译并安装了功能强大的 Xournal++。这款开源笔记工具不仅提供了出色的手写体验，还通过丰富的功能和插件系统满足了各种专业需求。

现在就开始使用 Xournal++，享受高效、灵活的数字笔记生活吧！🚀

温馨提示：建议优先使用打包方式（DEB 或 AppImage）进行安装，这样可以获得更好的维护体验和自动更新支持。

【免费下载链接】xournalppXournal++ is a handwriting notetaking software with PDF annotation support. Written in C++ with GTK3, supporting Linux (e.g. Ubuntu, Debian, Arch, SUSE), macOS and Windows 10. Supports pen input from devices such as Wacom Tablets.项目地址: https://gitcode.com/gh_mirrors/xo/xournalpp