---
title: "Import from Git V2：常见问题与排错"
language: "zh"
url: "https://docs.testany.io/zh/docs/import-from-git-v2-faq/"
markdown_url: "https://docs.testany.io/zh/docs/import-from-git-v2-faq.md"
translation: "https://docs.testany.io/en/docs/import-from-git-v2-faq.md"
last_updated: "2026-03-26T15:39:24+08:00"
---

# Import from Git V2：常见问题与排错

## 1. 为什么 GitHub 账号已经连上了，但仓库列表还是空的？

因为在 V2 里，账号连接和仓库访问范围是两件事。

请检查：

- 是否选中了正确的 installation
- 目标仓库是否已经被加入 GitHub App 范围
- GitHub 侧变更后，是否已经执行 `Refresh GitHub App Scope`

另见：[Import from Git V2：管理 GitHub 连接与仓库访问范围](https://docs.testany.io/zh/docs/import-from-git-v2-manage-connections.md)

## 2. 为什么向导里的 `Next` 按钮是灰的？

因为当前步骤还没有完成。

常见原因包括：

- 第 1 步：账号、installation、仓库或 runtime 还没选完整
- 第 2 步：分支或 pinned commit 还没选完整
- 第 3 步：导入根目录或文件还没选完整
- 第 4 步：一个或多个文件的必填元数据还不完整

## 3. 为什么 `Track Latest` 没有自动为新文件创建 Test Case？

因为 V2 把代码跟踪和关系变更拆开了。

如果要把新增文件纳入这条导入记录，必须在详情页里显式执行 `Import Added Files`。

## 4. 为什么源端删除文件后，没有自动删掉 Test Case？

因为 V2 不会在源文件消失时自动删除 Test Case。

您需要使用 `Mark Source Deleted`，把对应 binding 显式标记为 `source_deleted`。

## 5. 为什么 GitHub Webhook 的行为和我预期不一样？

Webhook 的行为取决于导入模式：

- `Sync Link + Track Latest`：Webhook 主要触发同步检查
- `Managed Import + Track Latest`：Webhook 可以推进 Mirror
- `Pinned Commit`：Webhook 不可用

无论哪种模式，Webhook 都不能替代 `Import Added Files` 或 `Mark Source Deleted`。

## 6. 为什么 `Sync` 按钮没有出现，或者是灰的？

常见原因包括：

- 当前是 `Sync Link + Track Latest`，这类记录本来就没有手动代码同步
- 当前记录固定在某个 commit 上
- 连接已经失效
- 已经有一条同步正在进行
- Mirror 已经是最新状态

## 7. 为什么创建之后不能改 Runtime？

这是 V2 的产品规则。

Runtime 会在创建导入记录时固定下来，因此请在第 1 步谨慎选择。

## 8. 删除 Import History 会发生什么？

删除一条导入记录时，系统会删除所有关联 Test Case。

如果这条记录是 `Managed Import`，对应的 Mirror 也会被立即删除。

## 9. V2 里最值得先搞懂的名词有哪些？

建议优先理解这些术语：

- `GitHub App installation`
- `Repository Access Scope`
- `Sync Link`
- `Managed Import`
- `Track Latest`
- `Pinned Commit`
- `Mirror`
- `source_deleted`

另见：[术语表](https://docs.testany.io/zh/docs/glossary.md)

## 本页术语

- [仓库访问范围 (Repository Access Scope)](https://docs.testany.io/zh/docs/glossary.md#repository-access-scope)
- [执行 (Execution)](https://docs.testany.io/zh/docs/glossary.md#execution)
- [测试用例 (Test Case)](https://docs.testany.io/zh/docs/glossary.md#test-case)
- [Mirror](https://docs.testany.io/zh/docs/glossary.md#mirror)
- [运行时 (Runtime)](https://docs.testany.io/zh/docs/glossary.md#runtime)