跨插件访问

由于nonebot2独特的插件加载机制，在使用python原有的import机制来进行插件之间的访问时，很可能会有奇怪的或者意料以外的情况发生。为了避免这种情况的发生，您可以有两种方法来实现跨插件访问：

第一种方法比较容易理解和实现，这里不再赘述，但需要注意的是，请不要将公共文件或者公共文件夹作为插件被nonebot2加载。

下面将介绍第二种方法——export和require机制：

使用export and require

现在，假定有两个插件pluginA和pluginB，需要在pluginB中调用pluginA中的一个变量varA和一个函数funcA。

在上面的条件中涉及到了两种操作：一种是在pluginA的导出对象操作；而另一种是在pluginB的导入对象操作。在nonebot2中，导出对象的操作用export机制来实现，导入对象的操作用require机制来实现。下面，我们将逐一进行介绍。

:::warning 警告

使用这个方法进行跨插件访问时，需要先加载导出对象的插件，再加载导入对象的插件。

:::

在pluginA中，我们调用export机制导出对象。

在export机制调用前，我们需要保证导出的对象已经被定义，比如：

varA = "varA"


def funcA():
    return "funcA"

在确保定义之后，我们可以从nonebot.plugin导入export()方法, export()方法会返回一个特殊的字典export：

from nonebot.plugin import export


export=export()

这个字典可以用来装载导出的对象，它的key是对象导出后的命名，value是对象本身，我们可以直接创建新的key-value对导出对象：

export["vA"] = varA
export["fA"] = funcA

除此之外，也支持设置属性的办法来导出对象：

export.vA = varA
export.fA = funcA

特别地，对于函数对象而言，export支持用装饰器的方法来导出，因此，我们可以这样定义funcA：

@export.sub
def funcA():
	return "funcA"

或者:

@export
def funcA():
	return "funcA"

通过装饰器的方法导出函数时，命名固定为函数的命名，也就是说，上面的两个例子等同于：

export["funcA"] = funcA

这样，我们就成功导出varA和funcA对象了。

下面我们将介绍如何在pluginB中导入这些对象。

在pluginB中，我们调用require机制导入对象。

:::warning 警告

在导入来自其他插件的对象时, 请确保导出该对象的插件在引用该对象的插件之前加载。

:::

我们可以从nonebot.plugin中导入require()方法：

from nonebot.plugin import require

require()方法的参数是插件名, 它会返回在指定插件中，用export()方法创建的字典。

require_A = require('pluginA')

在之前，这个字典已经存入了'vA'-varA, 'fA'-funcA或'funcA'-funcA这样的key-value对。因此在这里我们直接按字典索引的办法来导入对象:

varA = require_A["vA"]
funcA = require_A["fA"] or require_A["funcA"]

也可以用获取属性的方法来导入对象:

varA = require_A.vA
funcA = require_A.fA or require_A.funcA

这样，我们就在pluginB中成功导入了varA和funcA对象了。