CherryTree安装指南：跨平台部署完全手册

CherryTree是一款功能强大的开源笔记软件，支持富文本编辑、代码高亮、表格插入和文件管理等功能，是程序员和知识工作者的理想选择。本文将通过"准备篇→安装篇→验证篇→进阶篇"四个阶段，为你提供清晰、专业的跨平台安装指南，帮助你顺利部署这款高效笔记工具。

准备篇：系统兼容性检查与环境准备

在开始安装前，请确认你的系统是否满足CherryTree的运行要求，并完成必要的环境准备工作。

检查系统兼容性

CherryTree支持以下操作系统：

• Linux：基于Debian/Ubuntu、Fedora、Arch等主流发行版
• Windows：Windows 7及以上版本
• macOS：macOS 10.12及以上版本

准备必要工具

根据你的操作系统，需要提前安装以下基础工具：

• Linux系统：确保已安装终端模拟器和包管理器（如apt、dnf或pacman）
• Windows系统：无需特殊准备，只需确保有管理员权限
• macOS系统：建议安装Xcode命令行工具（后续步骤会说明安装方法）

安装篇：选择适合你的安装方案

Linux系统安装方案

推荐方案：使用系统专用脚本安装

这种方法适用于基于Debian的系统（包括Ubuntu、Linux Mint等），通过项目提供的专用脚本来简化安装过程。

1. 获取项目代码

   git clone https://gitcode.com/gh_mirrors/ch/cherrytree  # 克隆项目仓库到本地
   cd cherrytree/scripts  # 进入脚本目录
   

2. 执行对应系统版本的安装脚本

   sudo ./[系统版本号]  # 替换[系统版本号]为你的系统版本对应的脚本文件名
   

⚠️ 注意事项：执行脚本前请确认脚本文件名与你的系统版本匹配，不同版本的系统需要使用对应的脚本。

备选方案：源码编译安装

如果你需要获取最新开发版本，或者你的系统不支持专用脚本，可以选择从源码编译安装。

1. 安装编译依赖

   sudo apt-get install cmake g++ libgtkmm-3.0-dev libgtksourceviewmm-3.0-dev libxml++2.6-dev libsqlite3-dev libgspell-1-dev  # 安装编译所需的开发库和工具
   

2. 编译并安装

   mkdir build && cd build  # 创建并进入编译目录
   cmake ..  # 生成Makefile
   make -j4  # 使用4个线程进行编译
   sudo make install  # 安装到系统
   

Windows系统安装方案

推荐方案：图形化安装程序

1. 访问CherryTree项目发布页面，下载最新稳定版的安装程序
2. 双击运行下载的安装程序，按照安装向导的提示完成安装
3. 安装完成后，在开始菜单中找到CherryTree图标并点击启动

备选方案：便携版使用

对于需要在不同电脑间移动使用的用户，可以选择便携版：

1. 下载便携版ZIP压缩包
2. 将压缩包解压到任意目录（如U盘或移动硬盘）
3. 直接运行解压目录中的cherrytree.exe即可使用，所有配置和数据会保存在程序目录下

macOS系统安装方案

推荐方案：使用Homebrew安装

Homebrew是macOS上的包管理器，可以简化软件安装过程。

1. 安装Homebrew（如果尚未安装）

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"  # 安装Homebrew
   

2. 安装CherryTree

   brew install cherrytree  # 通过Homebrew安装CherryTree
   

备选方案：手动编译安装

1. 安装Xcode命令行工具

   xcode-select --install  # 安装Xcode命令行工具，提供编译所需的基础工具
   

2. 安装依赖库

   brew install gtkmm3 gtksourceviewmm libxml++ sqlite3 gspell  # 安装编译所需的依赖库
   

3. 克隆仓库并编译

   git clone https://gitcode.com/gh_mirrors/ch/cherrytree  # 克隆项目仓库
   cd cherrytree  # 进入项目目录
   mkdir build && cd build  # 创建并进入编译目录
   cmake ..  # 生成Makefile
   make && sudo make install  # 编译并安装
   

验证篇：确认安装完整性

安装完成后，需要验证CherryTree是否正确安装并可以正常运行。

启动CherryTree

• Linux系统：在终端输入cherrytree命令，或在应用菜单中找到CherryTree图标点击启动
• Windows系统：从开始菜单启动，或直接运行安装目录下的可执行文件
• macOS系统：在Launchpad中找到CherryTree图标，或在终端输入cherrytree命令

验证核心功能

成功启动后，你将看到CherryTree的主界面，包含左侧的树状导航和右侧的编辑区域。

尝试以下操作来验证核心功能：

1. 创建新笔记节点
2. 在编辑区域输入文本并尝试使用格式化工具
3. 插入一个简单的表格或代码块
4. 保存笔记并关闭程序，然后重新打开确认数据是否保存

✅ 如果以上操作都能正常完成，说明CherryTree已成功安装并可以正常使用。

进阶篇：优化配置与扩展应用

安装后必做的3项配置

1. 设置默认存储位置

   • 打开CherryTree，进入"Tools" → "Preferences"
   • 在"Storage"选项卡中设置默认笔记存储路径
   • 建议选择非系统盘的位置，便于备份和迁移

2. 配置代码高亮主题

   • 进入"Tools" → "Preferences" → "Editor"
   • 在"Syntax Highlighting"部分选择你喜欢的代码高亮主题
   • 可以从项目的styles/目录中选择更多主题

3. 设置自动备份

   • 进入"Tools" → "Preferences" → "Backup"
   • 勾选"Enable automatic backup"
   • 设置备份频率和备份文件保存路径

同类工具对比

工具	特点	适用场景
CherryTree	轻量级，支持树状结构，本地存储	个人笔记管理，代码片段收集
Notion	功能丰富，支持协作，云端存储	团队协作，项目管理
Typora	简洁美观，专注Markdown编辑	写作，文档创作
Evernote	多平台同步，OCR识别	跨设备笔记，资料收集

CherryTree的优势在于轻量级、本地存储保证数据安全，以及对代码高亮和树状结构的良好支持，特别适合程序员使用。

学习资源导航

• 官方文档：项目中的docs/目录包含详细的使用说明和功能介绍
• 用户手册：data/manual-install.txt提供了手动安装的详细步骤
• 样式主题：styles/目录下有多种编辑器主题可供选择和自定义
• 测试用例：tests/目录中的测试文件可以帮助你了解软件的各种功能

通过以上资源，你可以逐步深入了解CherryTree的高级功能，充分发挥这款优秀笔记工具的潜力。

希望本指南能帮助你顺利安装和使用CherryTree。如有任何问题，可参考项目文档或寻求社区支持。祝你使用愉快！