这是在知乎链接：我的obsidian插件开发的学习过程 - 知乎
因为这篇文章我会根据我最新体会不断更新，在知乎文章可以随时更改比较方便，所以首发在知乎，这里毕竟专家比较多，希望能够多指点。我是年过中旬的大叔，2月份才接触obsidian，感觉相见恨晚，所以一直在深入研究obsidian，因为对几个插件功能不是很满意，在作者issue发言，都被忽略所以奋而学习编程，我不是程序员，也没有干过这个工作，只是本科有过编程经验，3月份我才接触javascript和typescript的编程，所以文章有些认识可能不太准确，如果有问题请指出防止误导后学者。
前言
我学习javascript编程的最终目标是为了能够给自己做obsidian的插件，当我第一个插件做出来，我就明白要实现我的插件梦其实只需要时间了。因为obsidian的九成的插件都是开源的，你有大量的各种类型的源程序可以学习和借鉴。MDN和菜鸟上有最基础的语言知识。现在真是一个学习时代，影响学习效率最大的瓶径是我们自己。我尽量把插件开发相关的内容都放在这一篇文章里，所以这个文章是迭代。之所以这些方式来写文章，主要因为如果等所有任务完成再写文章，可能并不能如实反应真实的过程。如果有前后矛盾之处，我尽量不改原文，只是在后面补充内容并标注补充的时间。2022-05-03
准备
官网
Vault | Obsidian Plugin Developer Docs
上面链接一个爱好者发布的obsidian开发文档，其实也来自官网的github的内容，它不象MDN对每个函数和变量的属性和方法都有描述和示例，这个网站只是把所有的api罗列清单，网站上api说明我没发现有什么价值，因为vscode查找定义结果是一样的。我只推荐学习这个网站的guide目录的内容，对开发插件涉及几个模块都有详细的说明及示例。建议在阅读其他人的插件源程序之前应该认真把上面每篇文章都认真学习一遍。可以少走很多弯路。
环境
- git
因为我在研究obsidian同步的时候对git有深入的了解，在插件开发之初git主要是用来下载源程序，方便不同场合代码同步。git其实比较简单，而且网上资源比较丰富，将来在很多地方都会用到，所以早学早享受。经过我测试，用git clone来下载程序经常因为网络的原因而报致命错误，直接在github的代码菜单里下载其压缩包成功率奇高。
- node.js和typescript
对于初学者node.js这是必须要安装的项目，因为根据官网的指南在本地把ts编译成js的npm命令都依赖node.js环境。如果开发工具用vscode开发最好把node.js和typescript的环境配置好，至于ES6还是typescript的选择，我在github上看大部分插件源程序repo都显示typescript占了八九成。不过国外obsidian论坛里有一个用户发言我觉得还是很中肯的，其实真正高手只要写原生的javascript就够了。不过根据我的经验，刚入门就如此，有点难度，没有指南很多流程都要自己琢磨，而且源代码的语法格式也不太一样。所以有时候我们选择某个流程或工具，不是因为它是最好，而是用得人多而己。这样我们在遇到问题时，至少还能找到资料。
How to get started with developing a custom Plugin?
建库
GitHub - obsidianmd/obsidian-sample-plugingithub.com/obsidianmd/obsidian-sample-plugin
官网建议开发之前先把sample库复制到自己github的库中。上面是obsidian sample-plugin库的链接地址，按步骤以此为模板在github创建一个自己的库。记住要改成自己的库的名字，如果看不到"use this template"这个菜单，是因为你没有登录github上。我自己在开发插件的时候，并没有创建这个库，直接把库复制到本地。放到测试库里插件目录(plugins)里，直接进行开发，我主要在单位就是学习知识和背诵卡片，在家里开发代码。如果你两边都要开发，还是码云上创建一个库更靠谱一点。
模块
编程所需要引用三种模块：一个obsidian自身库中所有模块，node.js内置的四个模块，还有包括用户自定义模块的外置模块。引用语法common和es6都兼容，我开始编译时老早不到obsidian的库，后来发现有一些插件的源程序并不有把obsidian自带库上传到github上去，所以建议初学者务必按官网流程下载obsidian sample-plugin库，这个插件库最完整。初学者开始严格按官网流程，可以规避很多坑。
测试框架
我是修改Note Refacotr的时候涉及到这个概念，就大致了解一下，目前在obsidian国外论坛推荐两种测试框架：**Jest和Mocha，下面是链接，**这个资源站是官方提供还是爱好者整理的，我目前还没有整明白。只要你在论坛里问技术问题，就会被人推荐去访问这些资源，但资源很凌乱，不太象官网的资料。我对待测试框架和npm态度是：只要能用不影响我实现目标，我暂时不会深入的学习。因为我在写这段文章的时候，我只是停留在修改别人插件，而这些插件编译和测试的脚本都是别人配好的，每次编译都自动完成。如果想彻底搞明白这两样知识点，并会自己配置脚本，我估算一下这个坑比较大，要花费很多时间，目前目标还不需要我这样做。但我知道我最终要面对这个问题。
所以我现在也只是有意识收集一些基础知识，比如脚本一些关键词我还是能看懂，一些简单的报错还能知道怎么改，等到时机成熟我再彻底学习一遍。下面的链接是知乎上对测试框架简单介绍，有兴趣的朋友可以了解一下。不过根据我的经验，除非你之前接触过这东西，不然看了还是一头雾水。但这也是学习一个复杂的知识点必备过程。评估难度决定挂起，研究前置条件，然后从简单术语开始，逐步深入等到正式启动这个任务时，你已经对知识点概念和环境有大致的了解，对后面学习也非常有帮助。added:2022-05-07
优弧同学：2021 年 JavaScript 测试框架回顾0 赞同 · 0 评论文章
main.ts
一般来说越是功能复杂的插件，主程序main.ts越简单，main.ts包括：引导部分，定义类型和全局变量。主类一般继承自plugin类，主要有onload和onunload两个方法组成。一些次要的功能一般都模块化。作为外部模块由主程序在其onload方法中调用其方法及属性即可。这样整个程序结构清晰，日后升级和修改也比较方便。
调用已经导入的外部模块和主类的方法的语法格式是一样的
this.方法名 ：this.addCommand （），const { contentEl } = this;
但也有完整路径的格式,因为workspace并没有做为模块导入，这里只是作为app的属性
this.app.workspace.getActiveViewOfType(MarkdownView)
产生需求
因为之前我用quicker做一个却作，就是修改Note Refacotr的data.json文件，然后重载插件，对文件进行拆分。当时我对hot-fix的插件进行修改，只要data.json文件一改动，就自动重载插件。但我觉得这个插件用于开发比较合适但在平常使用会驻留内在占用资源。所以最好用命令行或侧边栏来启动，这样我可以用快捷键来重载插件。也可以让我的脚本每个过程都是可控的。所以我需要使用命令行方式来重载插件，只是实现这个功能就太简单了，所以我给自己又定更高的目标，就是用modal中suggestion模块实现在安装的所有插件清单里，随便选择一个插件重载。
开发工具
devtool
devtool一些小技巧可以让开发效率大幅度提升，在开发插件过程中我又发现一个小技巧：它就是编译代码块的功能，因为插件开发api文档过于简陋，所有示例也没有描述。所以我只能通过在devtool的命令面板来敲命令来看看某个方法有什么参数，某个类有什么属性，返回值是什么？但有一个难题如果是循环语句这种代码块我直接敲出来会报错，所以我在网上找到可以通过在source面板新建snippet来实现对代码块的运行。这又解决了我一个大问题。如下图，你只要在左侧的snippet文件名点击右键会有"run"就可以运行你编写的代码块。
npm
我编译ts文件一直用npx tsc，所以在开发之初我也用这个命令来编译main.ts文件，但出现很奇怪的现象，我的插件无法打开，一打开就报错。就这一问题我在国外obsidian论坛进行咨询，但很长时间也没有人理会我，老外还是很热情的，估计问题比较特殊，我当时卡在那里，这个问题在开发之初差点让我放弃了，后来我重新学习官网的插件开发说明，发现他推荐用npm run dev编译，我就死马就活马医，下载了npm，然后运行npm run dev之后就正常了。
开发插件过程中也就是这个坑比较深一点。但你只要按要求安装node.js和npm。在命令窗口进入开发插件目录，再运行npm run dev，再开始用vscode进行代码开发即可。
git
因为在研究obsidian同步的时候对git有深入的了解，开发之初git主要是用来下载源程序和办公室与家里同步。不过用git clone来下载程序经常因为网络的原因，经常报错，还不如直接下载其压缩包。
