> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 环境配置

> 配置 Devin 的环境，让每次会话开始时都已克隆你的代码仓库、装好工具，并备妥所需依赖。

<Tip>**Devin 可以帮你配置它自己的环境。** 只需启动一个会话并告诉它即可。[了解更多 →](/zh/onboard-devin/environment/blueprints#getting-started)</Tip>

<div id="what-is-devins-environment">
  ## 什么是 Devin 的环境？
</div>

Devin 的环境是 Devin 运行的工作空间：一个基于 Linux 的虚拟机，其中已克隆你的代码仓库、安装好工具、解析依赖并应用配置。它相当于开发者的笔记本电脑：操作系统、终端、已安装的工具链，以及已克隆的代码仓库。

你的环境配置会保存为一个**快照**，也就是一个冻结的、可启动的镜像，每个会话都会从它启动。只需配置一次，每个会话都会启动到这一已验证可用的状态。

<div id="why-environment-configuration-matters">
  ## 为什么环境配置很重要
</div>

Devin 的工作方式和任何开发者一样：克隆代码仓库、安装依赖、运行 lint、编译代码并执行测试。要完成这些工作，它需要一个可用的环境。没有环境，Devin 就无法构建你的项目、运行测试，也无法验证自己的工作成果。这就像你雇了一名开发者，却不给他配一台电脑。

环境配置为 Devin 提供从第一次会话起高效工作所需的工具、运行时、凭据和项目相关知识。它还能加快会话速度：你的快照中已经克隆好了代码仓库并安装了依赖，因此 Devin 可以直接开始高效工作，而不必每次都从头设置。

**这是你为提升 Devin 在你的代码库上的效果所能做的最有价值的一件事。**

<div id="how-sessions-work">
  ## 会话如何工作
</div>

每个会话都从一个**快照**启动；快照是环境的冻结、可启动镜像。

1. **快照**：预先构建的镜像，包含你的代码仓库、工具和依赖，并通过配置提前准备好。
2. **会话**：Devin 会从快照启动一个全新的副本。每个会话都从相同的干净状态开始。会话中的更改不会保存回快照。

当你的配置发生更改时，系统会自动构建新的快照。每个组织都恰好只有一个生效中的快照。该组织中的每个会话都从同一个快照启动。

<div id="before-you-start">
  ## 开始之前
</div>

在配置 Devin 的环境之前，请先确保 Devin 可以访问你的代码仓库：

<AccordionGroup>
  <Accordion title="非企业用户">
    1. **连接你的 SCM 提供商。** 前往 **设置 > 连接**，连接 GitHub、GitLab、Bitbucket 或 Azure DevOps。在设置过程中，选择 Devin 可以访问的代码仓库。详细指示请参阅[集成指南](/zh/integrations/overview)。

    完成后，你就可以继续配置环境。
  </Accordion>

  <Accordion title="企业用户">
    1. **连接你的 SCM 提供商 (enterprise admin) 。** 前往 **设置 > 集成**，连接你的 SCM 提供商。设置指示请参阅 [Git 集成](/zh/enterprise/integrations/git-integrations)。
    2. **授予每个组织访问其代码仓库的权限 (enterprise admin) 。** 前往 **设置 > 仓库权限**，为每个组织分配代码仓库。只有在你明确授予访问权限后，各组织才能查看或使用这些代码仓库。请参阅 [仓库权限](/zh/enterprise/integrations/git-integrations#repository-permissions)。
    3. **配置环境 (org admin) 。** 某个组织获得代码仓库访问权限后，即可继续进行下方的环境配置。
  </Accordion>
</AccordionGroup>

<Warning>
  如果你跳过这些步骤，那么当你尝试将代码仓库添加到环境中时，它们将不会显示出来。Devin 必须先通过你的 Git 集成获得代码仓库访问权限，然后才能进行克隆和构建。
</Warning>

<div id="choose-your-approach">
  ## 选择配置方式
</div>

你可以通过以下两种方式配置 Devin 的环境：

<CardGroup cols={2}>
  <Card title="声明式配置" icon="file-code" href="/zh/onboard-devin/environment/blueprints">
    **推荐。** 使用 YAML 格式 (蓝图) 定义你的环境配置。指定需要安装的内容、如何设置依赖，以及 Devin 需要了解的项目相关信息。系统会自动运行构建并生成快照。

    * 受版本控制
    * 自动更新
    * 可在不同层级间组合
    * 可复现
  </Card>

  <Card title="经典配置" icon="wand-magic-sparkles" href="/zh/onboard-devin/repo-setup">
    通过 Web UI 中的交互式向导配置 Devin 的环境。使用嵌入式终端，按引导依次完成各个步骤页面 (secrets、依赖、lint、test、run) 。

    * 可视化、分步骤
    * 无需 YAML
    * [迁移到声明式配置 →](/zh/onboard-devin/environment/migration)
  </Card>
</CardGroup>

<div id="related-pages">
  ## 相关页面
</div>

<CardGroup cols={2}>
  <Card title="蓝图参考" icon="book" href="/zh/onboard-devin/environment/blueprint-reference">
    蓝图的完整字段规范：各个部分、GitHub Actions 支持、环境变量和文件附件。
  </Card>

  <Card title="模板库" icon="copy" href="/zh/onboard-devin/environment/templates">
    适用于 Python、Node.js、Go、Java、Ruby、Rust 及高级模式的即用型蓝图模板。
  </Card>

  <Card title="从经典配置迁移" icon="arrow-right" href="/zh/onboard-devin/environment/migration">
    逐步指导你从交互式向导迁移到声明式蓝图。
  </Card>

  <Card title="环境管理" icon="building" href="/zh/enterprise/environment-management/overview">
    环境管理：3 层层级结构、secrets 和跨组织配置。
  </Card>
</CardGroup>