---
title: 原生小程序组件配置
summary: "介绍自定义组件 JSON 配置文件的声明方式及 usingComponents 组件引用路径。"
questions:
  - 自定义组件的 JSON 文件中必须声明什么字段？
  - usingComponents 支持哪几种组件路径形式？
  - 绝对路径形式的组件引用以什么字符开头？
  - 相对路径形式的组件引用基于什么目录？
  - 引用组件时路径地址需要注意什么？
---

`[componentPath].json` 文件用于标识当前为自定义组件，因此必须存在 `component: true` 的声明。自定义组件可互相引用。

## usingComponents

引用其他组件，组件路径支持：

1. 绝对路径形式，以 `/` 开头，表示小程序源码目录；
2. 相对路径形式，以 `.` 开头，基于当前 json 文件所在目录；
3. npm 三方包。

```json
{
  "usingComponents": {
    "foo": "/absolute/foo/index",
    "foo": "./relative/foo/index",
    "foo": "package/es/foo/index"
  }
}
```

注意：路径地址必须精确到文件名，不可省略缺省 index。

## 完整示例

```json
{
  "component": true,
  "usingComponents": {
    "li": "/components/custom-li/index"
  }
}
```