# Monorepo 设置 (/zh/deploy/monorepo)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 360 · updated: 2026-07-30 -->

将 Mintlify 配置为从 monorepo 中的指定目录部署文档。此设置可让你在包含多个项目或服务的存储库中，将文档与代码一同维护。

<Note>
  Monorepo 部署使用单个包含 docs 子目录的仓库。要将来自多个仓库的内容合并到一个站点，请参阅[多仓库部署](/zh/deploy/multi-repo)。
</Note>

典型的 monorepo 结构可能如下所示：

```text
your-repo/
├── apps/
│   ├── web/
│   └── api/
├── docs/
│   ├── docs.json
│   └── quickstart.mdx
└── package.json
```

在此示例中，你需要将文档路径设置为 `/docs`。

<div id="prerequisites">
  ## 先决条件 [#先决条件]
</div>

* 拥有你在 Mintlify 项目的管理员权限。
* 将文档文件整理在 monorepo 中的独立目录内。
* 文档目录中包含有效的 `docs.json` 文件。

<div id="configure-monorepo-deployment">
  ## 配置 monorepo 部署 [#配置-monorepo-部署]
</div>

<Steps>
  <Step title="访问 Git 设置">
    在你的控制台前往 [Git Settings](https://app.mintlify.com/settings/deployment/git-settings)。

    <Frame>
      <img className="block dark:hidden my-0 pointer-events-none" src="/_assets/e290b5878af258c5c5993e3776da7d45ca622b7b05e1c3e00ba3a39c0c178210" alt="Git Settings 菜单中的项目设置面板，其中 docs.json is in a subdirectory 开关已启用，并指定了 /docs 目录的路径。" />

      <img className="hidden dark:block my-0 pointer-events-none" src="/_assets/ce9cfe28d31b3a9342d387e4c4dc161132c677d1653b465d2a14e7bd84873857" alt="Git Settings 菜单中的项目设置面板，其中 docs.json is in a subdirectory 开关已启用，并指定了 /docs 目录的路径。" />
    </Frame>
  </Step>

  <Step title="设置文档路径">
    1. 打开 **docs.json is in a subdirectory** 开关。
    2. 输入文档目录的相对路径。例如，如果文档位于 `docs` 目录，输入 `/docs`。

    <Note>
      路径末尾不要包含斜杠。
    </Note>

    3. 选择 **保存更改**。 保存后会从配置的路径触发一次新的部署。
  </Step>
</Steps>