---
title: "Import from Git V2：连接 GitHub 并创建导入"
language: "zh"
url: "https://docs.testany.io/zh/docs/import-from-git-v2-create-import/"
markdown_url: "https://docs.testany.io/zh/docs/import-from-git-v2-create-import.md"
translation: "https://docs.testany.io/en/docs/import-from-git-v2-create-import.md"
last_updated: "2026-03-26T15:39:24+08:00"
---

# Import from Git V2：连接 GitHub 并创建导入

## 1. 开始前请先确认

在创建第一条 V2 导入记录前，请先确认：

- 您可以在 Testany 中连接目标 GitHub 账号。
- 目标仓库所属的个人账号或组织，已经为 `Testany Git Connector` 授予访问权限，或者您知道应该找谁来处理这一步。
- 当前租户下至少有一个可用的 `Runtime`。


> **警告**
>
> 如果目标仓库属于 GitHub 组织，通常需要先把目标仓库加入 `Testany Git Connector` 的访问范围。这个动作既可以由 GitHub 组织管理员在组织 installation 中完成，也可以由目标仓库管理员在仓库侧完成。


## 2. 打开 Import from Git V2

1. 进入 `Test Case Library`
2. 点击 `Register Test Case`
3. 选择 `Import from Git`
4. 在版本选择框中选择 `Import from Git V2`

进入 V2 页面后，您会看到两个主要区域：

- `Connection Management`
- `Imports`

其中 `Imports` 下又分成：

- `Add an Import`
- `Import History`

## 3. 第 1 步：Source & Environment

`Add an Import` 的第 1 步是 `Source & Environment`。

![Import from Git V2 第 1 步](https://docs.testany.io/docs/images/zh/import-git-v2-step-source-zh.png)

### 3.1 选择 Git 平台账号

先选择要用于本次导入的 GitHub 账号。

如果当前还没有连接任何账号，请先回到同页上方的 `Connection Management` 去完成连接。

### 3.2 选择仓库访问范围

选中账号后，再选择仓库访问范围。

这里实际上是在选择对应的 GitHub App installation，也就是：

- 某个个人账号上的 installation
- 或某个组织上的 installation

如果这里显示没有可用范围，说明 GitHub 账号虽然已经连上了，但仓库所属 owner 还没有提供可用的 GitHub App 访问范围。

### 3.3 选择仓库

访问范围就绪后，搜索并选择目标仓库。

仓库下拉框里只会显示在当前范围下**真正可导入**的仓库。

### 3.4 选择 Runtime

最后选择本次导入要绑定的 `Runtime`。


> **警告**
>
> Runtime 一旦选定，就不能再修改。


## 4. 第 2 步：Version & Mode

第 2 步是 `Version & Mode`。

![Import from Git V2 第 2 步](https://docs.testany.io/docs/images/zh/import-git-v2-step-version-zh.png)

### 4.1 选择分支

选择这条导入记录要跟踪的分支。

如果您没有手动选分支，Testany 会尽量预选仓库的默认分支。

### 4.2 选择 Track Latest 或 Pinned Commit

您必须在两种同步模式中选一种：

- `Track Latest`：跟踪所选分支的最新 commit
- `Pin to specific commit`：固定到某个特定 commit

如果选择 `Pin to specific commit`，Testany 会从 GitHub 加载最近的提交记录供您选择。


> **备注**
>
> 固定 commit 模式不支持 Webhook 同步。后续如果想更新，只能切换到另一个 commit，或者改回 `Track Latest`。


### 4.3 选择 Sync Link 或 Managed Import

然后选择导入模式：

- `Sync Link`：执行时从 Git 拉取脚本
- `Managed Import`：执行时从 Testany Mirror 拉取脚本

如果您的租户当前还不能使用 `Managed Import`，该选项会显示但处于禁用状态。

## 5. 第 3 步：Select Files

第 3 步是 `Select Files`。

![Import from Git V2 第 3 步](https://docs.testany.io/docs/images/zh/import-git-v2-step-files-zh.png)

### 5.1 先选导入根目录

在仓库浏览器中先选择一个目录作为导入根目录。

只有这个子树内的文件，才能被纳入本次导入记录。

### 5.2 选择受支持的测试文件

当前支持的文件类型包括：

- `.py`
- `.js`
- `.ts`
- `.jmx`
- `.json`
- `.java`

不受支持的文件仍然会显示在浏览器里，但不能被勾选。

### 5.3 勾选前先预览

您可以先点击文件预览内容，再决定是否勾选。

当选中文件过多时，Testany 也会给出提醒。在这种情况下，建议按批次导入，降低风险。

## 6. 第 4 步：Confirm Metadata

第 4 步是 `Confirm Metadata`。

![Import from Git V2 第 4 步](https://docs.testany.io/docs/images/zh/import-git-v2-step-metadata-zh.png)

对每个已选文件，您都可以检查并调整：

- `Name`
- `Executor`
- `Description`
- `Trigger Method`
- `Trigger Value`
- `Environments`
- `Labels`
- `Visibility`

### 6.1 执行器和触发方式

Testany 会根据文件扩展名自动推断执行器，并生成默认的触发方式。

但您仍然可以手动修改：

- `Executor`
- `Command` 或 `Path`
- 具体的触发值

### 6.2 使用 Apply to Similar Files

如果多个已选文件扩展名相同，且希望复用同一套元数据配置，可以使用 `Apply to Similar Files`。

它可以批量复制：

- executor
- trigger method
- environments
- labels
- visibility

## 7. 第 5 步：Confirm & Submit

第 5 步是 `Confirm & Submit`。

![Import from Git V2 第 5 步](https://docs.testany.io/docs/images/zh/import-git-v2-step-submit-zh.png)

在这里请再次核对摘要信息：

- 账号
- 仓库访问范围
- 仓库
- runtime
- 分支
- sync mode
- import mode
- 导入根目录
- 已选文件

然后点击：

- `Create Sync Relationship`，用于 `Sync Link`
- `Import to Mirror`，用于 `Managed Import`

## 8. 查看导入结果

提交后，Testany 会进入导入结果页。

![Import from Git V2 导入结果](https://docs.testany.io/docs/images/zh/import-git-v2-result-zh.png)

在这里您可以：

- 打开新创建的 `Import History Detail`
- 继续导入更多文件
- 查看失败文件及原因

如果您创建的是 `Managed Import`，这里还可能显示 Mirror 初始化状态。

## 9. 下一步看什么

完成首次创建后，建议继续阅读：

- [Import from Git V2：管理 GitHub 连接与仓库访问范围](https://docs.testany.io/zh/docs/import-from-git-v2-manage-connections.md)
- [Import from Git V2：维护 Sync Link 导入](https://docs.testany.io/zh/docs/import-from-git-v2-manage-sync-link.md)
- [Import from Git V2：维护 Managed Import 导入](https://docs.testany.io/zh/docs/import-from-git-v2-manage-managed-import.md)

## 本页术语

- [仓库访问范围 (Repository Access Scope)](https://docs.testany.io/zh/docs/glossary.md#repository-access-scope)
- [运行时 (Runtime)](https://docs.testany.io/zh/docs/glossary.md#runtime)
- [执行 (Execution)](https://docs.testany.io/zh/docs/glossary.md#execution)
- [Mirror](https://docs.testany.io/zh/docs/glossary.md#mirror)
- [执行器（Executor）](https://docs.testany.io/zh/docs/glossary.md#executor)