Github的使用指南

首次创建仓库

1.官网创建仓库

打开giuhub官网,右上角点击你的头像,随后点击your repositories

点击New开始创建仓库

如下图为创建仓库的选项解释

出现如下界面就可以进行后续的git指令操作了

2.git上传项目

进入需上传项目的所在目录,打开git命令行,输入如下命令开始初始化git仓库,这将在你的项目文件夹中创建一个名为 ".git" 的隐藏文件夹

复制代码
git init

将项目的所有文件添加到 Git 仓库

复制代码
git add .

提供一条提交信息,以便于跟踪更改,将 "Initial commit" 替换为你选择的提交信息,可随便填写

复制代码
git commit -m "Initial commit"

首次提交会出现如上图所示报错,需要配置 Git 的全局用户名和电子邮件地址,这样 Git 就可以将你的身份关联到提交的更改

复制代码
git config --global user.email "you@example.com"
git config --global user.name "Your Name"

将本地仓库与 GitHub 远程仓库关联,仓库链接替换成你自己的

复制代码
git remote add origin https://github.com/xf555er/MyFirstRepository.git

将本地项目推送到GitHub仓库,随后弹框要求登录github账号,至于默认分支是master还是main,可以在git命令行所示的括号里看到,例如此处我的默认分支是master

复制代码
git push -u origin master

此处我选择使用浏览器进行登录github账号

登录完后继续上传项目:git push -u origin master,等待项目上传成功

打开仓库主页可以发现,项目全部上传了

遇到的问题

项目push失败

问题详情

当我们将要把自己本地的项目push到github的仓库时,可能会出现了如下报错,这是网络问题导致的,毕竟github是国外的

复制代码
Failed to connect to github.com port 443 after 21046 ms: Couldn't connect to server

解决方法

首先你要准备一个梯子(这里我用的clash),开启梯子后自动会在系统开启一个端口代理,例如此处我的代理端口是7980

进入项目的git命令行,输入如下命令设置全局代理:

复制代码
git config --global http.proxy http://127.0.0.1:7890

git config --global https.proxy http://127.0.0.1:7890

设置完毕后就能正常推送项目至github了

vs项目上传失败

问题详情

若你出现如下图所示的情况,其原因是你试图上传到 GitHub 的文件大小超过了 GitHub 的文件大小限制。GitHub 允许的最大文件大小为 100 MB,但是推荐的最大文件大小是 50 MB。你可以看到,错误信息告诉你哪些文件超过了这个限制

此处我上传的是visual studio的项目,这些项目超大文件大部分在.vs目录上,这个目录通常是由 Visual Studio 自动生成的,包含了一些编译过程中的临时文件和其他非源代码文件,这些文件通常不需要(也不应该)被上传到代码仓库中

解决方法

在你的项目根目录下创建一个 .gitignore 文件(如果还没有的话),并在里面添加以下行来忽略 .vs 目录:

复制代码
.vs/

使用git rm --cached从 git 索引中移除 .vs 目录

复制代码
git rm -r --cached .vs/

提交改变,并再次推送到github

复制代码
git commit -m "Removed .vs directory"
git push -u origin master

如何项目覆盖更新

问题详情

有些时候你需要"覆盖更新"github的项目,我说的"覆盖更新"是指,Github仓库完全匹配你本地目录的文件,如果对应的本地文件不存在,那么Github仓库则需将这些文件删除掉

解决方法

1.进入你本地git仓库命令行, 使用git add. 将所有文件添加到git索引中

2.使用git add -u命令更新已被git追踪的文件。这个命令会记录文件的移除操作,所以如果你在本地删除了某个文件,它也会被从Github仓库中删除

3.使用 git commit -m "Updated files" 命令提交你的更改。请替换 "Updated files" 为你自己的提交消息

4.最后,用 git push origin master 命令将你的更改推送到Github

在最后一步你可能会出现如下图所示的情况。你遇到的这个错误表明远程Github仓库上的某些更改还未同步到你的本地仓库,因此Git阻止了你的推送操作。这是因为Git不确定应该保留哪个版本的更改,它不希望你不小心丢失任何数据。

这种情况的解决方法是使用强制推送,如下命令所示:

复制代码
git push -f origin master

如何更改关联的远程仓库

问题详情

当你要更改一个已经存在的本地仓库所关联的远程仓库时,可能会出现如下报错信息:error: remote origin already exists.

解决方法

首先,你可以使用以下命令检查当前的远程仓库配置,这将显示所有的远程仓库和它们的UR

复制代码
git remote -v

然后,你可以使用以下命令删除当前的远程仓库(通常名为origin

复制代码
git remote remove origin

接下来,你可以使用以下命令添加新的远程仓库

复制代码
git remote add origin your_new_repository_url

最后,你可以使用以下命令验证新的远程仓库是否已经正确设置

复制代码
git remote -v
相关推荐
Elasticsearch7 分钟前
4 种模态、100 多种语言、1 个向量空间:Microsoft Foundry 中的 Jina Embeddings v5
elasticsearch
黑十15 小时前
FDE 怎么快速搭一个可演示页面?最小前端方案
java·大数据·前端·数据库·人工智能
Databend16 小时前
OpenRaft 自定义 Membership,按部署拓扑选择 Quorum
大数据·数据库·数据分析
dong_junshuai16 小时前
每天一个开源项目#162 NGINX:流式响应背后的缓冲、背压与重试
github
测试员周周16 小时前
【agent评测】:真实系统演示工具调用长什么样,用例怎么设计,怎么测
前端·后端·github
Databend16 小时前
用 SQL 排查支付故障,OpenTelemetry 接入 Databend Cloud 实战
大数据·数据库·sql
Elasticsearch16 小时前
使用 Codex 来写入 PDF 文件并创建 AI Agent 对它进行问答
elasticsearch
上海潭龙东海科技有限公司17 小时前
智慧堆场动态模型三维实时孪生重构智能管控
大数据·网络·数据库·算法·重构
吴长建先生重名了17 小时前
Laravel 项目中使用 Eloquent 实现 IM
github
草莓熊Lotso18 小时前
【C++ 基于微服务的即时通讯系统】ElasticSearch 用户数据管理实现
linux·数据库·c++·elasticsearch·微服务·架构