【Mac 系统】GitHub从创建Repo到上传项目源码详细步骤

引言

git是版本管理工具，方便程序的版本管理，不联网就可以使用，git的作用就是对文件进行版本管理，方便在不同版本进行切换修改；
Github : 一个网站，用户存放代码及程序员之间的互相交流
通过git上传源码到github，或者同步你的本地代码和github的源码

1 安装git

打开终端
输入查看版本命令，如果你的MacOS没有安装，会提示命令行安装

git --version

2 创建repo

（1）打开浏览器，登录github，右上角的+号，创建你的项目名称

（2）名称必须是英文，其他可以是默认的，不勾选，点击创建即可。

（3）创建好后，显示SSH，别关掉，留着这个网址，后面通过终端上传文件，就是通过这个URL指定你的创建的该项目文件夹。

3 终端操作git

（1）cd到你要上传的项目目录
不需要压缩。本人的路径项目路径是/Users/mgege007/PostGraduate/PYTHON/Tensorflow-notebook-from peking-University/

cd /Users/mgege007/PostGraduate/PYTHON/Tensorflow-notebook-from peking-University/

（2）把当前项目变成git仓库

git init

此时目录多了一个.git文件夹，可以通过ls -ah查看
（3）把当前项目文件下的所有文件添加到本地缓存中，并通过git status添加的文件

#把该仓库里的所有文件加载到缓存里
git add .
#查看加载的文件
git status

（4）提交缓存

git commit -m “自己的项目注释”

如果出现以下内容，就需要输入github自己的账号和github的名字

（5）连接到服务器并提交
连接服务器，这里的网址，就是在以上步骤中提到的SSH，复制导致这里。

git remote add origin https://github.com/823316627bandeng/-TensorFolwNotebook-from-Peking-University.git

提交到服务器

git push -u origin master

（6）提示输入账号密码

注意：2021-8-13后开始，github不再支持自己账户的密码，需要在github平台上生成一个私钥token
Github创建个人访问令牌
用token去替代密码
等待加载就行，刷新GitHub就发现代码已经上传。

4 上传大文件

需要安装git-lfs插件

brew install git-lfs

cd upload #进入名为upload的文件夹，提前将要上传的大文件放入该文件夹下
git init #创建本地仓库环境
git lfs install #安装大文件上传应用
git lfs track * #追踪要上传的大文件，*表示路径下的所有文件
git add .gitattributes #添加先上传的属性文件(要先上传属性文件，不然有可能失败)
git commit -m "pre" #添加属性文件上传的说明
git remote add origin https://github.com/Youpeng-Zhang/MOP.git #建立本地和Github仓库的链接
git push origin master #上传属性文件
git add * #添加要上传的大文件，*表示路径下的所有文件
git commit -m "Git LFS commit" #添加大文件上传的说明
git push origin master #上传大文件

5 常见问题

1. 如果add后，想清除缓存的命令

git rm -r --cached .

2. 删除远程连接

git remote rm origin

3. 错误remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
   remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
   fatal: unable to access ‘https://github.com/823316627bandeng/Academic-paper-classification.git/’: The requested URL returned error: 403
   

因为从2021-8-13后开始，github不再支持自己账户的密码，需要在github平台上生成一个私钥token
Github创建个人访问令牌
用token去替代密码

4. 如果项目中包含了大于100M的单个文件，会导致上传失败，两种办法解决
   （1）第一种：让git忽略该文件，不上传它：解决办法博客
   （2）第二种：使用Git LFS。在这之前，先把不包含大文件的项目上传了，再进行下一步的步骤。就是先在该项目下复制到其他地方，成功上传不包含大文件的源码后，再复制回来。再执行以下步骤。
   git-lfs官网

第一步: 命令安装port install git-lfs或者下载到本地，执行install.sh脚本(./install.sh)

port install git-lfs

第二步： 通过打开终端执行git lfs install，验证安装是否成功。看到“ git lfs initialized”的输出说明安装成功

git lfs install

第三步： 初始化当前文件夹为git仓库，如果这个文件夹初始化过，那当下必定有一个.gitattributes文件。可以通过ls -ah查看。

git init

第四步： 通过这个命令跟踪你的超过100M的文件filename.x，就是更新.gitattributes这个文件

git lfs track “*filename.x”

第五步： 添加并commit gitattributes文件

git add .gitattributes

第六步： 然后再同步一下整个项目

git add .
git commit -m “提交大文件”
git push