# 从Github导入[](#从Github导入 "Permalink")

使用导入器，您可以将 GitHub 代码仓库导入 GitCode。

## 概览[](#overview "Permalink")

导入了项目的以下方面：

*   仓库描述
*   Git 存储库数据
*   Issue
*   拉取请求
*   Wiki
*   里程碑
*   标签
*   Release
*   拉取请求评论
*   定期发布和请求注释

保留对拉取请求和问题的引用，并且每个导入的存储库都保持可见性级别，除非该可见性级别受到限制 ，在这种情况下，它默认为默认项目可见性。

## 创建 GitHub 个人访问令牌

以下是在 GitHub 中创建个人访问令牌（PTA）的步骤：

1. 请确保你已经成功注册了 [GitHub](https://github.com) 账号，并登录了 GitHub
1. 访问 GitHub 的个人访问令牌（PAT）管理页，url 地址为 [Personal access tokens](https://github.com/settings/tokens)
1. 单击【Generate new token】 按钮，这一步会要求你输入 GitHub 账号密码，以确认是你本人在操作，输入你的 GitHub 密码即可
1. 填写你的个人访问令牌名称
1. 设置你的个人访问令牌有效期（ GitHub 访问令牌最大有效期为 1 年，建议设置 1 年）
1. 设置你的个人访问令牌的权限（建议勾选的权限包括 `Repo(全部)`,`User(全部)`,`write:packages`,`write:discussion`,`admin:repo_hook`)
1. 以上设置完成后，单击页面下方的【Generate token】生成你的个人访问令牌
1. 在创建成功页中，GitHub 会显示你的个人访问令牌，是一串字符。请及时复制并保存你的个人访问令牌，离开或刷新页面后，将无法再查看你新建的个人访问令牌

你也可以参考 GitHub 官方的教程来创建一个你的 GitHub 个人访问令牌 https://docs.github.com/cn/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token 


## 实现原理[](#how-it-works "Permalink")

导入 Issue 和拉取请求时，导入程序会尝试在数据库中查找其 GitHub 作者和 指派人（请注意，拉取请求在 GitCode 中被称为"合并请求"）。

为了导入成功，在Github 项目导入前，至少需要项目中的每个作者和指派人都应该满足下列条件：

*   有一个 GitHub 帐户，其[主要电子邮件地址](https://help.github.com/en/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address)与其 GitCode 帐户的电子邮件地址匹配。

如果在 GitCode 的数据库中未找到项目中引用的用户，则会将项目创建者（通常是启动导入的用户）设置为作者/指派人，但是对于该项目中 Issue 的评论，还是会提及到 Github 原作者。

如果导入项目的命名空间不存在，则导入项目时会创建新的命名空间/组织；如果名称空间已经被占用，则会将该项目导入至启动导入过程的用户的命名空间里，命名空间/代码仓库名称也可以由具有权限的用户进行编辑。

有关更多技术细节，您可以参考使用 GitHub 导入器开发人员文档。