向代码库添加文件

在 GitHub 上向代码库添加文件

通过浏览器添加到代码库的文件大小限制为每个文件 25 MiB。您可以通过命令行添加更大的文件，每个文件最大 100 MiB。更多信息，请参阅“使用命令行向代码库添加文件”。要添加大于 100 MiB 的文件，必须使用 Git 大型文件存储。更多信息，请参阅“GitHub 上的大型文件”。

您可以同时将多个文件上传到 GitHub。

如果代码库有任何受保护的分支，则无法使用 GitHub 编辑或上传受保护分支中的文件。您可以使用 GitHub Desktop 将更改移动到新分支并提交它们。更多信息，请参阅“关于受保护分支”和“在 GitHub Desktop 中提交和审查项目更改”。

您的代码库可能启用了推送规则集。推送规则集可能会根据某些限制阻止在代码库中创建新文件。推送规则集适用于代码库的整个 fork 网络。这意味着在根代码库中配置的任何推送规则集也适用于该代码库的每个 fork。更多信息，请参阅“关于规则集”。

您的代码库可能受到推送保护。使用推送保护，如果文件包含受支持的密钥（例如令牌），GitHub 将阻止将文件上传到代码库。您应该在尝试再次上传文件之前从文件中删除密钥。更多信息，请参阅“在 GitHub UI 中使用推送保护”和“在 GitHub UI 中使用推送保护”。

1. 在 GitHub 上，导航到代码库的主页。

2. 在文件列表上方，选择**添加文件**下拉菜单，然后单击**上传文件**。或者，您可以将文件拖放到浏览器中。

   

3. 要选择要上传的文件，请拖放文件或文件夹，或单击**选择文件**。

4. 在“提交消息”字段中，键入简短且有意义的提交消息，以描述您对文件所做的更改。您可以在提交消息中将提交归因于多个作者。更多信息，请参阅“创建具有多个作者的提交”。

5. 在提交消息字段下方，决定是将您的提交添加到当前分支还是添加到新分支。如果当前分支是默认分支，则应选择为您的提交创建新分支，然后创建拉取请求。更多信息，请参阅“创建拉取请求”。

   

6. 单击**提出更改**。

使用命令行向代码库添加文件

您可以使用命令行将现有文件上传到 GitHub 上的代码库。

此过程假设您已经

• 在 GitHub 上创建了一个代码库，或者拥有其他人拥有的现有代码库，您想为此代码库做出贡献
• 在您的计算机上本地克隆了代码库

1. 在您的计算机上，将您想上传到 GitHub 的文件移动到克隆代码库时创建的本地目录中。

2. 打开终端终端Git Bash。

3. 将当前工作目录更改为您的本地代码库。

4. 将文件暂存到本地代码库以进行提交。

   $ git add .
   # Adds the file to your local repository and stages it for commit. To unstage a file, use 'git reset HEAD YOUR-FILE'.
   

5. 提交已暂存到本地代码库的文件。

   $ git commit -m "Add existing file"
   # Commits the tracked changes and prepares them to be pushed to a remote repository. To remove this commit and modify the file, use 'git reset --soft HEAD~1' and commit and add the file again.
   

6. 推送更改到 GitHub.com 上的本地代码库。

   $ git push origin YOUR_BRANCH
   # Pushes the changes in your local repository up to the remote repository you specified as the origin
   

延伸阅读

• “将本地托管的代码添加到 GitHub”