设置#

安装和设置 Git#

Arrow 项目使用 Git 进行版本控制，所有常用操作系统均可轻松使用 Git。

您可以按照 GitHub（Arrow 仓库托管的地方）上的说明安装 Git，请遵循 快速入门说明。

设置 Git 后，不要忘记配置您的姓名和电子邮件

$ git config --global user.name "Your Name"
$ git config --global user.email [email protected]

并 使用 GitHub 进行身份验证，这样您就可以与 GitHub 交互，而无需每次执行 git 命令时都输入用户名和密码。

注意

本指南假设您熟悉命令行操作。某些 IDE 允许您管理 Git 仓库，但在这样做时可能会隐式运行不需要的操作（例如创建项目文件）。

例如，在 RStudio 中克隆它假设整个仓库是一个 RStudio 项目，并将在根目录中创建一个 .Rproj 文件。因此，*强烈建议*使用命令行或 Git 客户端克隆仓库。

获取源码#

Fork 仓库#

Arrow GitHub 仓库包含 Arrow C++ 库以及其他语言（如 Go、Java、Matlab、Python、R 等）的库。贡献的第一步是在您自己的 GitHub 帐户中创建仓库的 fork。

  1. 前往 apache/arrow。

  2. 点击右上角的 Fork 按钮。

    Fork the Apache Arrow repository on GitHub.

    在 GitHub 上 fork Apache Arrow 仓库的图标。#

  3. 选择将仓库 fork 到您的用户名，以便在 https://github.com/<您的用户名>/arrow 创建 fork。

克隆仓库#

接下来，您需要克隆仓库

$ git clone https://github.com/<your username>/arrow.git

并将 Apache Arrow 仓库添加为名为 upstream 的远程仓库。

$ cd arrow
$ git remote add upstream https://github.com/apache/arrow

验证您的 upstream#

您的 upstream 应该指向 Arrow GitHub 仓库。

在 shell 中运行

$ git remote -v

应该会得到类似于以下的结果

origin    https://github.com/<your username>/arrow.git (fetch)
origin    https://github.com/<your username>/arrow.git (push)
upstream  https://github.com/apache/arrow (fetch)
upstream  https://github.com/apache/arrow (push)

如果您正确完成了所有操作，现在您应该在 arrow 目录中拥有代码副本，以及两个分别引用您自己的 GitHub fork (origin) 和官方 Arrow 仓库 (upstream) 的远程仓库。