【清晰教程】利用Git工具将本地项目push上传至GitHub仓库中 - 指南

Git 是一个分布式版本控制系统，由 Linus Torvalds 创建，用于有效、高速地处理从小到大的项目版本管理。GitHub 是一个基于 Git 的代码托管平台，提供了额外的协作和社交功能，使项目管理更加高效。它们为项目代码管理、团队协作和持续集成提供了强大的支持。

目录

创建仓库

初始化本地Git

添加文件到暂存区

提交更改

连接远程仓库

推送文件到远程仓库

确认推送

---

创建仓库

在GitHub上创建一个仓库用于存放项目，完成仓库设置后点击Create repository即可创建仓库。

• 仓库模板（Repository template）：提供了一个下拉菜单，用户可以选择一个模板来初始化仓库。默认选择“No template”（无模板）。

• 所有者（Owner）：显示了仓库所有者的用户名或头像，用户需要选择或确认仓库的所有者。

• 仓库名称（Repository name）：必填字段，用户需要自定义仓库的名称。

• 描述（Description）：可选字段，用户可以输入仓库的描述信息，以便其他人了解仓库的用途。

• 公开或私有（Public/Private）：用户可以选择仓库是否公开。

  • 公开仓库：任何人都可以看到这个仓库，用户可以选择谁可以提交更改。

  • 私有仓库：用户可以选择谁可以看到和提交到这个仓库。

• 初始化仓库（Initialize this repository with）：

  • 用户可以选择是否添加一个 README 文件，这是项目的详细描述文件。

  • 用户可以选择添加 .gitignore 模板，用于指定哪些文件不应该被 Git 跟踪。

• 选择许可证（Choose a license）：用户可以选择一个许可证，以告诉其他人可以做什么和不能做什么。默认选择“None”（无许可证）。

 

创建完成后，通过Quick setup引导可以复制仓库链接

 

 

初始化本地Git

打开命令行，进入本地项目目录

如果本地项目目录中还没有 .git 目录，需要通过运行 git init 命令来初始化一个新的 Git 仓库。

git init

 初始化完成后，可见.git 目录

添加文件到暂存区

使用 git add 命令将文件添加到暂存区。可以添加所有文件或特定文件。例如，添加所有文件可以使用：

git add .

或者添加特定文件，例如：

git add train.py

警告信息是 Git 在处理文件行尾符时产生的。它表明在下次 Git 操作（如提交或拉取）时，Git 会将文件 train.py 中的行尾符（Line Feed，LF）替换为 Carriage Return Line Feed（CRLF）。在不同的操作系统中，文本文件的行尾符有不同的表示方式：

• Unix/Linux 使用 LF（\n）作为行尾符。

• Windows 使用 CRLF（\r\n）作为行尾符。

• Mac OS 9 及更早版本 使用 CR（\r）作为行尾符。

Git 可以通过配置来处理这些不同的行尾符，以确保跨平台的兼容性。

 

提交更改

使用 git commit 命令提交暂存区的更改，同时添加提交信息，例如"first commit"：

git commit -m "first commit"

连接远程仓库

使用 git remote add 命令添加远程仓库，粘贴对应的仓库链接：

git remote add origin https://github.com/your_username/your_repository.git

其中 your_username 和 your_repository 分别是GitHub 用户名和仓库名。

https://github.com/your_username/your_repository.git

这里使用最初创建的test仓库

 如遇用户信息配置报错Author identity unknown. 或 fatal: unable to auto-detect email address xxx.可参照【解决办法】Git报错Author identity unknown. 或 fatal: unable to auto-detect email address xxx.-CSDN博客

推送文件到远程仓库

使用 git push 命令将本地文件推送至 GitHub 远程仓库。设置需要推送的对应分支：

git push -u origin main

这里仓库默认分支是 main ，故使用 main 分支。如果需要推送其他分支，例如分支 master，则将 main 改为 master。首次推送会要求登录GitHub，输入账号密码登入即可。

如遇分支匹配报错error: src refspec main does not match any.或error: failed to push some refs to 'https://github.com/xxx/xxx.git'.可参照【解决办法】Git报错error: src refspec main does not match any.-CSDN博客

确认推送

推送完成后，刷新GitHub仓库页面即可查看到推送的文件和提交历史。