PyCharm 2025.3 Help

管理托管在 GitHub 上的项目

检出项目(克隆)

您可以直接从 PyCharm 克隆您想要参与贡献的 仓库 ,并基于其创建新的 项目 。

  1. 在主菜单中,转到 Git | 克隆。 如果 Git 菜单不可用,请选择 VCS | 从版本控制获取

  2. 从版本控制获取 对话框中,选择左侧的 GitHub

  3. 通过以下任一方式登录 GitHub :

    • 如果您已有令牌,请点击 使用令牌 ,然后将令牌粘贴到 令牌 字段中,并点击 登录

    • 否则,请点击 通过 GitHub 登录

      在打开的浏览器窗口中输入您的 GitHub 凭据。 如果您启用了 双重身份验证 ,系统会要求您输入一个通过 SMS 或移动应用程序发送给您的代码。

  4. 从与您的账户及其所属组织关联的所有 GitHub 项目列表中选择一个仓库。

    从列表中选择一个仓库
  5. 目录 字段中,输入将创建本地 Git 仓库的文件夹路径。

  6. 如果您希望执行具有受限历史记录的 浅克隆 ,请选择 浅克隆,将历史记录截断为 复选框,并指定要克隆的提交数量。

    稍后您可以在主菜单中选择 Git | 取消浅克隆存储库 来获取其余历史记录。

  7. 点击 克隆

    如果您希望基于这些源创建项目,请在确认对话框中点击 。 PyCharm 会自动将 Git 根目录映射设置为项目根目录。

在 GitHub 上共享项目

您可以为本地开发的 项目 添加远程 GitHub 仓库,以便他人查看或参与贡献。

  1. 打开您想要共享的 项目 。

  2. 如果您的项目已由 Git 跟踪,请在主菜单中转到 Git | GitHub | 在 GitHub 上共享项目

    如果您尚未启用版本控制集成,请在主菜单中转到 VCS | 在 GitHub 上共享项目

  3. 如果您已在 PyCharm 中 注册了您的 GitHub 账户 ,将使用这些凭据建立连接。

    如果您尚未在 PyCharm 中注册您的账户,将打开 登录 GitHub 对话框。 指定您的访问令牌,或使用您的登录名和密码请求新的令牌。

  4. 与 GitHub 建立连接后,将打开 在 GitHub 上共享项目 对话框。 指定新仓库名称、远程名称,并输入项目描述。

    如果您不想允许其他 GitHub 用户公开访问您的仓库,可以选择 私有 选项。

    在 GitHub 上共享项目对话框

    您在 远程 字段中指定的名称稍后将在 Git | 管理远程 对话框中显示。 有关更多信息,请参阅 添加远程仓库

  5. 点击 共享 以初始化新仓库并将 项目 源代码上传到其中。

跳转到文件的 GitHub 版本

您可以从 PyCharm 跳转到文件的 GitHub 版本。 PyCharm 会检测当前处于活动状态的分支以及该文件的最新修订,并在您的网络浏览器中在相应的提交中打开所选文件的 GitHub 副本。

  1. 执行以下任一操作:

    • 在主菜单中选择 Git | GitHub | 在 GitHub 上打开

    • 在编辑器或 项目视图 中选择一个文件,并在上下文菜单中选择 在以下位置打开 | GitHub

      打开该文件的 GitHub 版本
    • 在 项目视图 中选择该文件,按 Ctrl+Shift+A ,然后键入 Open on Github

  2. 如果您已登录 GitHub ,将在浏览器中打开该文件的远程版本。

    否则:

    • 在打开的浏览器窗口中输入您的 GitHub 凭据。 如果您启用了 双重身份验证 ,系统会要求您输入一个通过 SMS 或移动应用程序发送给您的代码。

如果您从编辑器打开文件的 GitHub 版本,该文件也会自动滚动到当前行。

如果该文件指向多个远程,将提示您选择相应的仓库。

最后修改日期: 2025年 12月 2日