Back to Blog

Obsidian 入门12:国内用户怎么方便地安装第三方插件,告诉你 3 条路

林小卫很行

这是一个「Obsidian × AI」系列。

我会从最基础的认知开始,慢慢写到资料整理、写作工作流,再到怎么把 AI 接进来。

如果你还没看前几篇,可以先看 Obsidian 入门 10:从一个模板,到一套真正用得上的模板系统Obsidian 入门 11:写日记这件事,可能只差一个 Calendar


在上一篇里,我建议大家去安装 Calendar 插件。但很多新手反馈,在这一步就被卡住了:

Feedback

“点击第三方插件,它弹出一堆警告,我该点哪?” “转了半天圈,根本打不开社区市场,我是不是废了?” “我也想一键安装,但国内网络好像没这个‘一键’功能……”

如果说 Obsidian 本身是一个毛坯房,那社区插件(Community Plugins) 就是各种各样的家电、软装,甚至带上了整套全屋智能系统的精装房。

这一篇,我们就来专门解决如何“拿走钥匙”,以及如何在国内这种特殊的网络环境下,安全、顺滑地把这些“黑科技”搬回家。


第一把钥匙:认清“两个入口”

很多新手在设置页面会发现两个长得很像的东西:Appearance(外观)Community plugins(第三方插件)

请记住这个价值几百小时“折腾时间”的避坑点:

  • 外观(Appearance):它是管“脸面”的。你在这里换主题(Themes)、调字体、改颜色。
  • 第三方插件(Community plugins):它是管“脑子”的。它决定了你的软件能不能画图、能不能统计字数、能不能自动整理日历。

不要在主题市场找功能,也不要在插件市场找美化。 认清了这两个入口,你就赢过了 50% 的新手。


第二把钥匙:解锁“受限模式”

当你第一次点击“Community plugins/第三方插件”时,Obsidian 会弹出一个让你心里发毛的红色警告。

它会告诉你:官方默认开启了受限模式(Restricted mode),不建议你随便装第三方插件,因为这些插件是由全球各地的开发者贡献的,它们有权读取你的本地文件夹。

为什么要锁起来? 这其实是官方在推卸……哦不,是在进行风险提示。既然是社区生态,质量和安全性确实良莠不齐。

怎么解开? 点击「关闭」即可关闭安全模式。在 2026 年,绝大多数热门插件(如 Calendar, Dataview)都是经过社区几万人验证过的,只要你不去乱下一些来路不明的插件,安全性是有保障的。


第三把钥匙:掌握“安装大法”

解开了受限模式,接下来就是最关键的一步:如何把插件装进去。这里我总结了三条路线,建议你根据自己的情况对号入座。

路线 A:官方市场直装(随缘路线)

如果你具备特殊的网络环境,直接点击「浏览」打开插件市场。

CleanShot 2026-03-29 at 08.42.56.png|400

接着用关键词搜索,找到你想要的插件,点击进去之后,点击「安装」。 CleanShot 2026-03-29 at 08.44.10.png|400

安装后,点击「启用」。

CleanShot 2026-03-29 at 09.18.37.png|400

但对于国内绝大多数用户来说,这一步通常卡在“正在加载”或者“连接失败”。

路线 B:手动安装(硬核路线)

这是最稳妥、能让你看清底层逻辑的方法。所有的 Obsidian 插件本质上就是文件夹里的几个文件。

  1. 找到插件源:去 GitHub 下载插件的 Release 包(通常包含 main.js, manifest.json, style.css),如果没有打包在庄子啊一起的压缩包,那么,直接下载这3个文件也可以。
  2. 找到库目录:打开你的 Obsidian 库文件夹,找到隐藏的 .obsidian 文件夹。
    • Mac 用户:按 Cmd + Shift + . 显示隐藏文件夹。
    • Windows 用户:在文件资源管理器中开启“显示隐藏的项目”。
  3. 放置文件:进入 .obsidian/plugins 目录(如果这是你第一次装插件,这个 plugins 文件夹需要你自己手动创建一个),建立一个和插件同名的文件夹(如 calendar),把下载好的文件扔进去。
  4. 刷新并开启:回到 Obsidian 的第三方插件设置页,点击刷新,开启即可。

Obsidian 入门11:写日记这件事,可能只差一个 Calendar 中所说的 Calendar 插件为例,我们先去搜索引擎用关键词“calendar 插件 obsidian github”进行搜索即可找到对应的 Github 仓库。 CleanShot 2026-03-29 at 09.32.00.png|400

接着点进进入 Github仓库,点击右侧的「Releases」 CleanShot 2026-03-29 at 09.33.50.png|400

选择最新的一次 Release,然后将main.js, manifest.json, style.css下载到本地。 CleanShot 2026-03-29 at 09.37.05.png|400

接着,找到你的 Vault也就是 Obsidian 库的目录,打开隐藏文件夹.obsidian,将刚刚下载的文件拖入plugins文件夹中。 CleanShot 2026-03-29 at 09.41.32.png|400

最后面来到 Obsidian 设置里面的第三方插件选项,点击右上角的“刷新“按钮重新加载插件目录。

找到你刚刚拖动进去的插件名称,选择「启用」即可。

CleanShot 2026-03-29 at 10.12.24.png|400


国内访问 Github的方法

如果你在国内,访问不了 Github,可以访问https://steampp.net/下载后开启网络加速,即可正常访问 Github。 CleanShot 2026-03-29 at 09.54.02.png|400

选择合适的下载渠道。Windows 用户也可在微软应用商店搜索「Watt Toolkit」进行下载。 CleanShot 2026-03-29 at 10.00.40.png|400

下载好后安装,并打开软件。进入网络加速,勾选 Github,点击右上角的一键加速即可。按下一键加速后,可能有些需要设置的步骤,按照提示进行操作即可。 CleanShot 2026-03-29 at 10.03.18.png|400

路线 C:PKMer 方案(国内首选)

如果你觉得手动安装太麻烦,那 PKMer(中文社区插件市场) 就是为你量身定制的。

它的逻辑是:“先手动装一个种子,再用种子长出整个森林。”

  1. 安装 PKMer 插件:按照“手动安装”的方法,先去 pkmer.cn 下载一个 PKMer 的插件包并安装好。别怕麻烦,这可能是你最后一次需要手动操作,以后在 Obsidian 里装插件就全是“一键式”了。 CleanShot 2026-03-29 at 10.08.11.png|400 下载压缩包 CleanShot 2026-03-29 at 10.09.47.png|400

  2. 开启 CDN 加速:在 Obsidian 里开启 PKMer 后,你就不再需要忍受官方市场的龟速。PKMer 提供了国内的 CDN 加速镜像。

    按照”手动安装“的方法,安装好后,打开插件。 CleanShot 2026-03-29 at 10.16.37.png|400

  3. 一键安装:直接在 PKMer 提供的市场界面里搜索、下载、更新插件。它不仅下载快,还贴心地提供了全中文的插件使用文档。

    点击进入即可,即可进行搜索浏览,寻找自己中意的插件了。 CleanShot 2026-03-29 at 10.18.17.png|400


写在最后:警惕“插件焦虑”

拿到了钥匙,不代表你要把整个市场的家电都搬回来。

Obsidian 圈子里有个很危险的倾向:“折腾插件的时间,远超过记笔记的时间。”

每一个插件的加入,都会增加软件的复杂度和你的探索使用成本。我的建议是:带着问题找插件,而不是带着插件找问题。

(IP形象 是)

当你觉得日记没法按日期看,再去装 Calendar;当你觉得搜索太慢,再去装 Omnisearch。

好了,现在你已经拿到了钥匙。请回去完成 Obsidian 入门 11:写日记这件事,可能只差一个 Calendar 里的最后一步吧。

进阶阅读

如果入门系列让你对 Obsidian 产生了兴趣,这里有几篇我自己折腾出来的实战经验:

记得关注,我们下期见。