终端命令行版安装与 WSL 环境准备

终端版（CLI）是 Joplin 的隐藏彩蛋：没有图形界面，却能在服务器上跑同步、在命令行里查笔记，是很多人选它的理由之一。

前置条件

需要先安装 Node.js 12 以上版本。各平台的 Node 安装方式见 Node.js 开发者文档的包管理器指引，例如 Debian/Ubuntu 上常用的方式：

# 以 NodeSource 源为例，或使用系统自带的 nodejs 包
sudo apt install nodejs npm

安装命令

macOS、Linux 与 Windows（经 WSL）通用以下命令：

NPM_CONFIG_PREFIX=~/.joplin-bin npm install --loglevel=error -g joplin
sudo ln -s ~/.joplin-bin/bin/joplin /usr/bin/joplin

默认把程序装在 ~/.joplin-bin 目录，再用软链接把 joplin 命令放进系统路径。如果你的 npm 全局权限本来就配置得当，直接 npm -g install joplin 也行。

启动

joplin

进入终端版界面后，输入 :help 可以查看全部命令。常用操作比如：

• :mknote 标题——新建笔记；
• :search 关键词——搜索；
• joplin sync（在 shell 里执行）——手动触发一次同步，配合 crontab 可以做定时同步，例如每 30 分钟同步一次的写法：

*/30 * * * * /path/to/joplin sync

它与桌面版的关系

• 数据目录与桌面版各自独立，但同步到同一个目标后内容一致；
• 想让终端版与桌面版共用本地数据，需要手动指定相同的数据目录（进阶用法，官方文档有说明）；
• 终端版同样支持 Evernote ENEX 导入（import /path/to/file.enex）。

Node 版本要求与安装细节可能随版本变化，以官方最新版文档为准。