---
source_url: https://docs.dolphindb.cn/zh/progr/statements/use.html
fetched_at: 2026-05-19T09:02:08Z
category: progr
title: use
sha1: 8f76c587cdca9bbf7ca1f1307663857602e98e9d
---

# use

要使用一个模块，在模块名前加上"use"关键字。

```dolphindb
use example::ch9
```

使用 *use* 语句可以调用定义在该模块中的函数。由于不同的模块可以定义相同名字的函数，通过以下规则来区分同名的函数调用：

- 通过模块命名空间区分函数名。

  - 引用定义在该命名空间的函数。
  - 所有DolphinDB内置函数定义在根模块::下。例如，::add(3,4)指的是根模块下的add函数。
- 未指明模块命名空间。

  - 如果当前模块定义了被调用的函数，那么该调用指向当前模块中的函数。
  - 如果只有一个已导入的模块中含有被调用的函数，那么该调用指向这个已导入模块中的函数。
  - 如果超过一个以上的已导入模块都包含了被调用的函数，则抛出异常。
  - 如果导入的模块中不包含被调用的函数，搜索根命名空间。如果在根命名空间也没有找到被调用的函数，抛出异常。

2.00.12 版本前，use 语句仅支持调用 .dos 文件；2.00.12 及之后版本，use 语句支持调用 .dos 文件或 .dom 文件。

注意：

- 若查找目录下存在同名的 .dos 和 .dom 文件，则优先读取 .dos文件。
- 若要加载的 .dom 文件有依赖其他的文件，则会一并加载。
- 若要更新已使用 use 加载的 .dom 文件或 .dos 文件，则需要先调用 clearCachedModules 函数清除缓存。
- 若在 server 初始化时已使用 loadModule 加载 .dom文件或 .dos文件，则启动后再使用 use 加载同名文件将不生效。

自 3.00.0 版本起，支持通过 use 语句切换当前 catalog。使用时，须在 use
后加上“CATALOG”或“catalog”关键字。

```dolphindb
use CATALOG catalog1
```

相关信息：[module](module.html)
