github是一个基于git的代码托管平台,付费用户可以建私人仓库,我们一般的免费用户只能使用公共仓库,将本地代码上传,也就是代码要公开。同时,我们也可以使用其强大的git命令去clone ,fork感兴趣的项目。
一. 注册GitHub账号
github官网地址:https://github.com/。
二. Git下载及安装
1.windows版本:git for windows
2.安装完成后会有以下三个功能(上图),或者鼠标右键(下图)
三. 配置Git, 连接github
1. 打开git bash, 设置用户名和邮箱
$ git config --global user.name "github 用户名"
$ git config --global user.email "github 注册邮箱"
配置完成后,通过下面的命令可以查看配置信息,验证信息是否正确
$ git config --list
2.根据邮箱生成公钥SSH
$ ssh-keygen -t rsa -C "your_email@youremail.com"
后面的your_email@youremail.com
改为你在github上注册的邮箱,之后会要求确认路径和输入密码,我们这使用默认的一路回车就行。成功的话会在c:/Users/....
下生成.ssh
文件夹,进去,打开id_rsa.pub
,复制里面的key
。回到github上,进入 Account Settings(账户配置),左边选择SSH and GPG keys ,New SSH key ,title随便填,粘贴在你电脑上生成的key,然后点击Add SSH key 即完成。
3.为了验证是否成功,在git bash下输入:
$ ssh -T git@github.com
如果是第一次的会提示是否continue,输入yes就会看到:You've successfully authenticated, but GitHub does not provide shell access 。这就表示已成功连上github。
四. 上传本地项目到Github
1.首次要在GitHub先创建一个仓库,用来存储你的项目。
步骤:(1)先用鼠标点右上角的 “ + ”,然后再点 “New repository” 。
(2)在 ''Repository name'' 所对应那一项上写上你本次上传的项目名称,在 “Description” 所对应那一项上写上你本次上传的项目的一些简单介绍,以方便别人浏览。下面的 “Public” 、"Private" 是权限,是说你这个项目是给全世界的人看,还是私密的。最后点 “Create repository”。
(3)“Create repository”后生成如下界面,在这里你要记住 “Quick setup - if you're done this kind of thing before” 这一行下的“SSH”后面的内容,可以点击复制。
注:项目名称务必用英文表示 ,不然用中文建立的仓库名会被 “ - ”取代,如下所示。
2. 打开git bash 输入相关命令上传本地项目
(1)cd 到 项目路径下(比如项目在D盘下,相关路径目录名最好都为英文防止出错)
$ cd d:/your_program_name
(2)输入 " git init ",作用是项目里面会创建一个隐藏的.git文件
$ git init
执行命令后出现的结果:
(3)再输入 " git add . ", 这个是将项目上所有的文件添加到仓库中的意思,如果想添加某个特定的文件,只需把' . '换成这个特定的文件名即可。
$ git add .
(4)输入 " git commit -m "first commit ",表示你对这次提交的注释,双引号里面的内容可以根据个人的需要改。例如 " git commit -m "第一次提交 "
$ git commit -m "first commit"
(5)输入 "git remote add origin https://刚才建立的仓库地址(四-1-(3)中的可复制的地址)" 将本地的仓库关联到github上。
$ git remote add origin https://你自己建立的仓库地址
(6)最后一步,输入 "git push -u origin master ",这是把代码上传到github仓库的意思。
$ git push -u origin master
完成这些命令后 ,你可以去github上仓库看到你上传的文件。
注意:1.如果你的项目里面有空位子文件夹,GitHub会跳过不会上传,你可以在空文件夹里面随便写个readme.txt,即可解决。
2.如果你不想上传某些文件,git为我们提供了一个.gitignore文件只要在这个文件中申明那些文件你不希望添加到git中去, 这样当你使用git add .的时候这些文件就会被自动忽略掉。
五.Clone项目到本地
直接用git命令clone项目到本地的前提是完成 一 git的相关配置。
1. 进入想要clone的项目,点击 绿色方块 “Clone or download”, 点击复制 https://........地址。
2. cd到你想要保存项目的路径下。
3.输入下面的命令等待完成克隆。
$ git clone 你复制的地址