初学者如何上传项目到 Github

任何与技术世界相关的开发人员或专业人士都知道它是什么 GitHub然而，并不是每个人都掌握了 上传项目到 Github 并充分利用该平台提供的版本控制、团队协作和专业可见性的潜力。

因此，从这个意义上来说，无论是初学者还是专家，都常常会感到有些迷茫。在本文中，你将学习 我们告诉你如何做，因为 有几种选择或方法如果您希望您的项目可供协作或供其他人轻松查看和下载，请继续阅读以了解所有详细信息。

什么是存储库以及为什么要将其托管在 GitHub 上？

Un 仓库 它是存储项目文件和文件夹的虚拟空间，以及在开发过程中发生的更改历史记录。这些历史记录允许 管理版本、恢复到以前的状态、与他人协作并清晰记录您的工作进度。.

在以下位置托管存储库 GitHub 它具有多项优势：

• 版本控制： 您的更改已被记录，您可以撤消、审查或共享开发的任何部分。
• 云备份： 一旦发生任何局部事件，您便可避免丢失重要信息。
• 专业形象： 由于是公开的，任何人都可以看到您的作品，从而丰富您的作品集。
• 简单的协作： GitHub 让其他人可以轻松地通过拉取请求、问题或分支为您的项目做出贡献。

入门：先决条件和环境准备

在将项目上传到 Github 之前，请确保您的计算机上安装了以下软件：

• GitHub 上的帐户。 在平台上创建存储库至关重要。
• Git已安装。 它是基本的版本控制工具，可让您管理更改。您可以从其 官方网站。在基于 Linux 的系统上，您可以通过运行以下命令来执行安装 sudo apt-get install git 在航站楼。
• 代码编辑器或 IDE。 像 Visual Studio Code 这样的选项（VSCode）使流程更简单。如果您想利用编辑器与 GitHub 的直接集成，建议您下载以下工具之一。

安装完成后 Git 在您的系统上，第一步是使用您的 姓名和电子邮件 （此数据将用于签署您的提交。）从终端运行以下命令：

git config --global user.name "TuNombre"
git config --global user.email [email protected]

此配置是 全球的 并且你只需要在你的团队中做一次。

在 GitHub 上创建存储库

现在是时候创建托管项目的空间了。按照以下步骤从 GitHub 网页界面执行此操作：

1. 访问您的个人资料 GitHub.com 然后按下按钮 “新的” 创建一个新的存储库。
2. 进入 姓名 存储库所需的，并添加了 描述 简要但具体地说明项目的目的。
3. 选择是否将存储库 公立或私立如果您希望其他人能够查看和参与，请选择公开。
4. 您可以选择创建文件 README.md 自动。建议使用此文件，因为这是其他开发人员访问存储库时首先看到的内容。
5. 点击 创建存储库 完成该过程后，您的存储库将准备好接收文件。

准备本地项目以上传到 GitHub

创建仓库后，下一步就是在计算机上准备项目文件夹，将项目上传到 GitHub。请按照以下说明在终端中操作：首先使用以下命令找到正确的路径： cd:

cd tu-carpeta-del-proyecto

现在初始化本地 Git 存储库：

git init

这将创建一个名为 .git 存储 版本历史记录 以及其他内部文件。

 

上传代码到 GitHub：终端中的完整流程

初始化本地存储库后，我们将通过运行以下命令将所有内容上传到 GitHub：

1. 将所有文件添加到暂存区 和：

git add .

2. 提交 记录第一个检查点：

git commit -m "Primer commit"

3. 将本地存储库与远程存储库链接。取代 NOMBRE_USUARIO y NOMBRE_REPOSITORIO 通过真实数据：

git remote add origin https://github.com/NOMBRE_USUARIO/NOMBRE_REPOSITORIO.git

4. 将更改上传到 GitHub （分支 main o master （视情况而定）：

git push -u origin main

在一些较旧的存储库或配置中，主分支是 master 而不是 main如果出现错误，请检查主分支的名称并在上面的命令中替换它。

如何从 VSCode 上传项目到 Github

现代编辑器如 VSCode 它们与 Git 和 GitHub 原生集成。以下是如何轻松实现：

• 在编辑器中打开您的项目文件夹（“文件 → 打开文件夹”）。
• 访问面板 源代码控制 （源代码控制）位于侧边栏。
• 如果还没有，请点击“初始化存储库”。这相当于以下命令 git init.
• 初始化后，您将看到一个按钮 “发布到 GitHub”如果这是您第一次，您需要授权 VSCode 和您的 GitHub 帐户之间的连接。
• 选择将存储库发布为公共或私有。
• 通过标记更改并添加描述性消息来准备第一次提交的文件。
• 发布您的项目，您可以轻松地从编辑器同步更改。

此选项非常适合那些喜欢留在开发环境中的人，并且使日常项目管理变得更加容易。

从 GitHub 网站手动上传文件

另一种选择，特别是对于小型项目，是从 Web 界面手动上传文件：

1. 进入GitHub上新创建的仓库。
2. 点击下拉菜单 添加文件 并选择 上传文件.
3. 将文件或文件夹从您的计算机拖放到浏览器窗口。
4. 在底部添加确认消息并点击 提交更改 上传文件。

对于处于积极开发中的项目来说，此方法效率较低，但对于添加特定文件、文档和其他项目很有用。

使用 GitHub 时的高级管理和最佳实践

上传项目仅仅是开始。为了充分利用 GitHub 并保持专业的组织结构，我们建议遵循以下额外的最佳实践：

• 保持 README.md 为最新。 这是您项目的简介信。它解释了项目的用途、安装方法、使用方法以及所有相关细节。您可以直接在线编辑，也可以使用 Markdown 语法在编辑器中编辑。
• 创建工作分支。 不要在“主分支”或“master”分支中进行所有更改。使用单独的分支来发布新功能或修复问题。之后，您可以使用拉取请求 (PR) 来合并它们。
• 上传 .gitignore 文件 避免共享敏感或自动生成的数据，例如 node_modules 文件夹、临时文件或本地配置文件。
• 定期同步本地和远程存储库。 使用 git pull 使您的本地副本保持最新，以适应贡献者可能做出的任何更改。
• 小心管理遥控器。 如果您更改了远程源，请使用 git remote -v 审查相关存储库和 git remote remove origin 必要时可将其移除。

克隆并协作项目：下一步

一旦您的存储库位于云端，您就可以使用以下方式将其克隆到任何其他计算机：

git clone https://github.com/TU_USUARIO/TU_REPOSITORIO.git

这将创建项目的本地副本，包括其所有内容 变更历史记录如果您希望文件夹使用不同的名称，可以将其添加到命令末尾。为了防止命令创建新文件夹并将文件直接放入当前目录，请添加一个句点：

git clone https://github.com/TU_USUARIO/TU_REPOSITORIO.git .

在 GitHub 上与其他用户协作的关键在于学习分支、拉取请求和代码审查的流程。这样，你就能接受外部贡献，并以有组织、高效的方式进行团队协作。

常见错误及解决方法

上传项目时，您可能会遇到一些常见问题。以下是一些最常见的问题及其解决方法：

• 尝试推送到没有主分支的空存储库- 如果远程存储库创建时没有 README.md，并且从未推送过分支，请确保推送具有正确名称的第一个分支，通常是“main”或“master”。
• 同步冲突：当本地和远程同时发生更改时，请先执行以下解决操作： git pull 并在做之前解决冲突 git push 再次。
• 许可证不足：确保您拥有正确的凭据，并检查远程 URL 拼写是否正确（https 或 ssh，视情况而定）。
• 忘记添加重要文件：查看并更新您的文件 .gitignore 以免遗漏关键文件或意外上传私人信息。

将您的项目上传到 GitHub 可以彻底改变您的工作流程：您可以随时恢复过去的版本、进行协作并向全世界展示您的工作。