Git使用入门手册.docx

Git使用入门手册.docx

《Git使用入门手册.docx》由会员分享，可在线阅读，更多相关《Git使用入门手册.docx（16页珍藏版）》请在冰豆网上搜索。

Git使用入门手册

Git使用入门手册

版本/状态

作者

参与者

日期

备注

1.0

2017/2/9

初稿完成

1.gitlab基础功能预览

1.1欢迎页面

访问地址：

1.2Profile

显示个人相关的扼要描述。

点击右上角图标，弹出下拉菜单，选择Profile选项。

显示的内容包含：

个人的活动信息、组信息、贡献的工程、个人的工程、代码片段。

1.3Settings

个人相关信息设置及展示页面。

点击右上角图标，弹出下拉菜单，选择Settings选项。

内容包含：

个人基础信息设置、账号信息设置、应用程序设置、聊天设置、访问令牌、邮箱设置、密码设置、通知设置、SSHkeys设置、首选项、审计日志。

1.4Help

帮助中心。

可查看gitlab的相关帮助文档。

1.5Signout

登出操作。

1.6Project

project页面显示用户能够访问的工程列表。

点击左上角的菜单图标，弹出左侧导航菜单，点击project。

进入工程列表。

点击工程名称，即可查看工程的相关信息。

1.7Activity

activity页面显示活跃的操作状态列表（即操作信息）。

点击左上角的菜单图标，弹出左侧导航菜单，点击activity。

进入活跃的操作状态列表。

1.8Group

group页面显示用户的组信息。

点击左上角的菜单图标，弹出左侧导航菜单，点击group。

进入用户的组信息页面。

1.9Milestones

milestones页面显示工程的里程碑信息。

点击左上角的菜单图标，弹出左侧导航菜单，点击milestones。

进入工程的里程碑信息页面。

1.10Issues

issues页面显示工程的问题列表。

点击左上角的菜单图标，弹出左侧导航菜单，点击issues。

进入工程的问题列表页面。

1.11MergeRequests

mergerequests页面显示收到的mrege请求信息。

点击左上角的菜单图标，弹出左侧导航菜单，点击mergerequests。

进入mrege请求列表页面。

1.12Snippets

snippets页面显示收到的代码片段信息。

点击左上角的菜单图标，弹出左侧导航菜单，点击snippets。

进入代码片段列表页面。

2.添加SSHKey

GitLab使用公钥或非对称加密，它通过用您的“私钥”锁定通信信道来加密通信信道，并允许可信方使用“公钥”解锁它。

点击右上角用户图标，选择Settings选项，选择SSHkeys。

根据页面描述可以看到，首先需要生成sshkey。

2.1生成SSHKey

安装Git工具后，进入gitbash，输入ssh-keygen按照步骤，即可生成sshkey。

另外，我们还可以通过eclipse附带的功能生成sshkey。

Eclipse生成sshkey步骤如下。

1），点击导航菜单栏Windows，选择Preferences，左侧搜索框输入SSH，点击搜索到的SSH2节点，右侧SSH2面板选中KeyManagement选项卡，点击GenerateRSAKey，即可生成sshkey。

点击SavePrivateKey，即可保存（最好保存到默认的用户sshkey目录）。

2.2添加SSHKey

打开*.pub文件，复制内容，粘贴到gitlab中SSHKey（Settings->SSHkeys）对应的textarea中，点击Addkey即可。

3.客户端配置

安装完git，进入gitbash，通过命令进行客户端配置。

3.1设置用户信息

配置命令如下：

$gitconfig--globaluser.name"JohnDoe"

$gitconfig--globaluser.emailjohndoe@

3.2设置客户端换行配置

$gitconfig--globalcore.autocrlffasle

$gitconfig--globalcore.safecrlftrue

4.开发过程

EGit是eclipseIDE的集成开发工具。

4.1安装egit

插件url：

 http:

//download.eclipse.org/egit/updates

4.2egit功能预览

Commit：

提交文件。

Stashes：

储藏操作。

当你正在做一项复杂的工作时,发现了一个和当前工作不相关但是又很讨厌的bug.你这时想先修复bug再做手头的工作,那么就可以用gitstash来保存当前的工作状态,等你修复完bug后,执行'反储藏'（unstash）操作就可以回到之前的工作里。

PushtoUpstream：

推送文件到服务器当前分支。

FetchfromUpstream：

从远程获取最新版本到本地仓库，不会自动进行merge本地仓库。

Pull：

从远程获取最新版本到本地，并自动进行merge本地仓库操作。

SwitchTo：

切换/创建切换分支。

Merge：

merge操作。

Reset：

重置提交操作。

ShowinHistroy：

查看提交日志。

4.3eclipse中git信息配置

点击导航菜单栏Windows，选择Preferences，左侧搜索框输入git，点击搜索到的git节点。

点击展开git节点。

点击Configuration节点。

如果按照前面步骤设置了git的用户信息，在右侧面板中就可以看到用户的相关信息。

否则，可以在此处以Key、value的形式添加用户信息。

4.4导入远程的git工程到工作空间

在projectexplorer区域，右键选择import->import。

点击展开git节点，选择ProjectsfromGit（withsmartimport），点击Next，选择CloneURI，粘贴项目主页复制的gitproject的url，点击Next，进入BranchSelection，点击Next，在LocalDestination页面，选择Directory（即你在本地的工程存储路径），点击Next，进行导入信息展示页面，点击Finish即可。

4.5git添加文件操作

本地项目中新增/修改/删除文件后，选中工程，右键选择Team，选择AddtoIndex，即将修改的文件添加到暂存区（也可以在commit操作时进行AddtoIndex操作）。

4.6git提交文件操作

选中工程，右键选择Team，选择Commit，eclipse显示GitStaging面板。

左侧分为上下两个部分。

上本分为未暂存的文件（可选中该区域的文件，右键点击AddtoIndex，将修改的文件添加到暂存区），下部分为暂存的（待提交）文件（选中该区域的某个文件，双击可对比该文件上个版本与工作空间的内容）。

在右侧CommitMessage区域的textarea中输入提交信息，点击Commit，即可提交到本地git仓库中。

（点击CommitandPush，即可提交到本地git仓库以及push到服务器git仓库中）

4.7git重置提交文件操作

若提交文件后，发现提交的问题不正确，可重置提交操作。

选中工程（注：

最好备份当前更新的文件，否则reset造成本地文件丢失），右键选择Team，选择Reset，选择要回退到的分支（Local节点为当前本地分支，后面带有commitid缩写；References为当前各HEAD指针指向的版本，后面带有commitid缩写；RemoteTracking为git远程仓库分支，后面带有commitid缩写），点击reset，当前工作空间内容即reset到对应的版本了。

reset操作时有三种操作类型可选：

Soft、Mixed、Hard。

Soft：

仅回退commit信息（HEAD指针），不回退暂存区（Index）和工作区（WorkingDirectory文件）源码。

Mixed：

回退commit信息（HEAD指针）和暂存区（Index），只保留工作区（WorkingDirectory文件）源码。

Hard：

所有更改都将恢复到所选分支/标记/Commit版本。

工作区（WorkingDirectory文件）源码会变为上一个Commit版本的内容，未提交的更改都将丢失，因此该操作必须确认。

4.8git推送文件操作

选中工程，右键选择Team，选择PushtoUpstream即可。

4.9查看提交历史记录

选中工程，右键选择Team，选择ShowinHistory。

4.10创建分支

1，选中工程，右键选择Team，选择选择Switchto，选择Newbranch，弹出创建分支页面。

2，输入工程名称（选择Checkoutnewbranch，即可在创建分支后，将当前工作空间切换到该分支），点击Finish。

4.11Merge分支

切换到要Merge的目标分支上，选中工程，右键选择Team，选择Merge，展开RemoteTracking，选择想要Merge的分支，点击Merge。

4.12通过gitlab发送merge请求到master

1，选择对应的project，点击branches。

点击对应分支后面的MergeRequest按钮。

2，在NewMergeRequest页面输入相关内容。

注意：

写清楚description（merge描述），assignee（merge操作对象），sourcebranch，targetbranch。

3，点击Submitmergerequest。

即完成了merge请求操作，进入Mergerequest展示页面。

4.13通过gitlab接受merge请求

1，接收merge请求的用户，会收到通知（当然在project中的MergeRequests后面也会显示merge请求数量）。

点击通知按钮，进入消息列表。

2，点击Done，开始处理。

选择Done选项卡，点击merge请求消息，进入merge请求操作页面。

3，点击Commits选项卡，即可看到本次merge的提交记录。

4，点击右侧的commitid的缩写。

即可查看本次提交的内容。

5，确定可以merge后，点击AccpetMergeRequest，即开始进行merge操作。

6，merge完成后，显示相关消息。

7，进入工作空间，进入merge的目标分支，进行pull操作，再查看history，即可看到merge日志。

4.14merge冲突

如果当前merge请求的内容存在冲突，则进入merge页面后，会显示当前merge请求存在冲突。

4.15解决merge冲突

根据页面提示，需要在本地解决冲突，或者在本地进行merge操作。

点击Mergelocally按钮，就可以看到相关命令指示操作。

1，从远程获取最新版本到本地仓库，并检出merge的源分支（如上图为：

future208）。

2，切换到merge的目标分支（如上图为：

master）。

3，在eclipseIDE中进行merge。

4，到本地资源文件或IDE中打开冲突的文件。

5，在本地资源文件或IDE中解决冲突的文件。

6，将最新修改推送到服务器。

7，merge完成。

通过查看git日志和gitlabmergerequest页面即可查看。