freeplane/freeplane · 上手攻略
- 仓库：freeplane/freeplane
- 链接：https://github.com/freeplane/freeplane
- 分类：knowledge-management
- 作者：Tom
- 更新：2026-08-10
这是什么
Freeplane 是一款开源（GPL）的心智图（Mind Map）/概念图工具，支持思维整理、知识管理、项目规划与信息导航。它由 Java 开发（OSGi + Swing），跨平台运行，只要有 Java 环境即可，支持 Windows / macOS / Linux，以及从 U 盘直接运行（便携模式）。
其定位是 XMind、MindMeister 等商业工具的开源替代，但功能深度远超标配：内置脚本（Groovy）、公式系统、LaTeX 渲染、MCP（Model Context Protocol）服务端、AI 集成、批量导出（HTML/Markdown/PDF）等。
解决什么问题
- 个人知识管理：将零散笔记整理为结构化思维导图，支持双向链接与全局搜索。
- 项目管理：用思维导图替代线性文档，规划任务、拆分里程碑、追踪依赖。
- 学术写作：LaTeX 公式渲染，配合 Freeplane 内置的 PDF 导出做笔记与文献管理。
- 团队协作：导出为 HTML 后内网共享，或用脚本生成结构化报告。
- AI 辅助工作流：内置 MCP 服务端，可将思维导图暴露给大模型做分析与推理。
快速安装
方式一：下载安装包（推荐）
前往 SourceForge 下载页 下载最新版的 .exe（Windows）或 .dmg（macOS）安装包，直接安装即可。需提前安装 Java 17+（JRE 或 JDK 均可）。
# 验证 Java 版本
java -version
# openjdk version "17.0.x" ...
# Windows 用户下载 .exe 安装；macOS 下载 .dmg
# Linux 用户可下载 .tar.gz 便携版，解压即用
方式二：便携模式（无需安装）
下载 .zip 或 .tar.gz 便携版，解压到任意目录（含 U 盘），双击 freeplane*.exe 或运行 freeplane.sh 即可。配置文件保存在解压目录，不污染系统。
方式三：Docker（仅服务端，实验性）
# 实验性，仅用于无头操作
docker pull freeplane/freeplane:latest
docker run -v /path/to/maps:/root/.freeplane freeplane/freeplane:latest
系统要求
- Java 17 及以上（推荐 Temurin / OpenJDK）
- 内存 512 MB 以上（复杂大图建议 2 GB+）
- 磁盘 200 MB+
⚠️ 注意：Java 21 部分版本与 Freeplane 1.12.x 有已知兼容问题，建议优先使用 Java 17 LTS。
核心用法
新建与基本操作
- 启动后自动创建一个中心节点（Root Node）。
- 按 Tab 添加子节点，Enter 添加同级节点。
- 双击节点可编辑文字；右键可调出格式化菜单（颜色、图标、折叠等）。
导出功能（高频使用）
// 在 Freeplane 内置脚本中导出当前地图
// File → Export → 选择格式
// 支持：HTML, Markdown, PDF, PNG, XMind, FreeMind (.mm)
常用导出路径：
- HTML 单文件：File → Export → HTML (single file) — 发给同事无需安装任何软件即可查看。
- Markdown：适合导入 Obsidian、Logseq 等双链笔记工具。
- PDF：适合存档与打印。
脚本与自动化（高级用法）
Freeplane 内置 Groovy 脚本引擎，可实现节点批量处理、自定义公式、调用外部 API。
// 示例：在 Freeplane Scripts 面板中运行
// 遍历所有子节点，给它们加上序号
def i = 1
node.children.each { child ->
child.text = "${i}. ${child.text}"
i++
}
// 示例：AI 调用（需先配置 MCP 服务端）
// 在 Scripts → Ask AI 中使用
def response = askAI(node.text, "请将以下内容总结为 3 个要点：")
node.details = response
AI 集成（MCP 服务端）
Freeplane 1.12+ 内置 MCP 服务端，可将思维导图暴露给外部 AI：
# 在 ~/.freeplane/freeplane.properties 中启用 MCP
mcp.enabled=true
mcp.port=9876
启用后，Claude、GPT 等支持 MCP 的 AI 工具可以直接读取和编辑 Freeplane 地图。
公式系统（LaTeX 语法）
在节点中输入 LaTeX 公式：
$ \sum_{i=1}^{n} x_i^2 $
Freeplane 会自动渲染为数学公式，适合学术笔记。
快捷键速查
| 快捷键 | 功能 |
|---|---|
| Tab | 添加子节点 |
| Enter | 添加同级节点 |
| F2 | 编辑节点文字 |
| Ctrl+L | 添加折叠节点 |
| Ctrl+Shift+U | 展开全部节点 |
| Ctrl+E | 导出当前地图 |
| Ctrl+Shift+→ | 复制格式到其他节点 |
典型适用场景
- 论文笔记与文献管理：用思维导图管理文献阅读笔记，LaTeX 公式支持理工科重度用户。
- 项目规划与 WBS 分解：将大型项目拆解为可执行子任务，支持甘特图插件。
- 第二大脑 / PKM：配合 Obsidian 双向链接使用，Freeplane 做顶层结构，Obsidian 做详细内容。
- 会议记录与决策树：用思维导图记录脑暴结果，支持图标与颜色编码优先级。
- 教学与知识传递：导出 HTML 单文件，学生无需安装软件即可在浏览器中浏览完整课程结构。
坑与注意
⚠️ Java 版本兼容性：Java 21 在部分 Linux 发行版上存在 UI 渲染 bug，表现为菜单栏消失。优先使用 Java 17 LTS。
⚠️ 大图性能：节点超过 500 个时，使用折叠（Fold）功能避免渲染卡顿；定期运行 node.optimizeMindMap() 脚本清理无效节点。
⚠️ 文件格式：.mm（FreeMind 格式）兼容性最好，但部分样式会丢失；建议同时保存原生 .freeplane 格式。
⚠️ 脚本安全：Freeplane Groovy 脚本在沙盒中运行，但 allowScriptUseLocalSecurityManager=false 时可绕过沙盒，不要打开来源不明的 .mps 文件。
⚠️ 协作限制：Freeplane 原生不支持实时多人协作，需要通过 Git 共享 .freeplane 文件或导出 HTML 静态页分发。
⚠️ macOS 安全提示：首次运行需要「允许来自非 App Store 的应用」，在系统偏好设置 → 安全性与隐私中手动放行。
与同类对比
| 特性 | Freeplane | XMind | Obsidian（双向链接） |
|---|---|---|---|
| 开源 | ✅ GPL | ❌ 商业 | ✅ BSD |
| 价格 | 免费 | 免费版有限制 | 免费 |
| LaTeX 支持 | ✅ 原生 | ❌ | ✅ 插件 |
| 脚本扩展 | ✅ Groovy | ❌ | ✅ Templater/插件 |
| AI 集成 | ✅ MCP 服务端 | ❌ | ✅ 插件 |
| 便携模式 | ✅ U盘运行 | ❌ | ✅ |
| 协作 | ❌ | ✅ 付费版 | ✅ |
| 导出格式 | 10+ 种 | 5+ 种 | 2 种（需插件） |
结论：如果你需要免费 + 可脚本化 + LaTeX + 便携的心智图工具，Freeplane 是最强选择；如果需要实时多人协作，XMind 付费版更合适；如果以双链笔记为核心、思维导图为辅助，Obsidian 配合 Freeplane 插件使用效果最佳。
一句话推荐结论
Freeplane 是最强开源心智图工具——免费、跨平台、脚本化、AI 集成、LaTeX 支持、U盘便携，适合对知识管理有深度的个人用户和学术工作者。