初识git、GitHub、GitLab、GitBook_git和gitbook区别-优快云博客

本文介绍了Git作为版本控制工具的基础知识，以及如何在GitHub和GitLab上进行项目管理和代码协作。同时，详细讲解了GitBook的安装和使用流程，包括创建书籍、编辑内容、预览和构建静态网站。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、git、GitHub、GitLab、GitBook的简单定义

1、git ：是一种版本控制系统，是一个命令工具
2、GitHub :开源代码库及版本控制系统，GitHub同时提供公共仓库和私有仓库，但如果要使用私有仓库，是需要付费的。
3、GitLab ：解决了GitHub创建私人仓库收费问题，同时支持企业搭建属于自己的GitLab仓库。提高数据的安全性。
4、GitBook ：GitBook 是一个基于 Node.js 的命令行工具，可以与Markdown 和 Git 结合，来管理文档，预览、制作电子书，其托管到云端（比如 GitHub、GitLab），实现多人协作。

GitHub、GitLab共同点

1、为开发团队提供了存储、分享、发布和合作开发项目的中心化云存储的场所。
2、GitHub、GitLab都是基于git开发的管理代码的软件。
3、两者的官网账号通用，使用方法基本一样。

二、git安装使用

1、git下载： https://git-scm.com，一路默认安装
安装成功后，进入cmd控制页面，能查看版本成功即可，输入：

git --version

2、在cmd控制页面，进行git的配置账户、邮箱

git config --global user.name "xxx"git config --global user.email "XXX.com"

#查看是否配置成功
git config --global --list

3、创建git仓库
3.1、创建项目目录

mkdir test #创建一个空目录
cd test  #进入到空目录中

3.2、进入test目录，将test目录变成一个git可以管理的仓库

git init #初始化目录

3.3、完成之后，在test目录下，会增加一个 .git目录，即本地仓库创建好
在这里插入图片描述

4、设置 ssh密钥，以便通过ssh来拖动或推动项目代码到gitlab

4.1、#可查询是否有添加过，若执行后找不到文件，则没有

cd ~/.ssh

4.2、生成key在当前目录，一路回车

ssh-keygen -t rsa -C “你在GITLAB上的邮箱地址”

4.3、找到生成的key目录，打开id_rsa.pub，复制

在这里插入图片描述

4.4、在gitlab上面添加key，点击账号–点击Settings–点击SSH KEYS–将id_rsa.pub内容复制到框中–添加即可，如图所示已添加完成

在这里插入图片描述

4.5、测试密钥是否添加成功

ssh -T git@xxgitlab地址

在这里插入图片描述
5、上传本地仓库
5.1、创建本地仓库的项目文件，如下，增加了一个summary.md

5.2、将文件添加到暂存区

git add .

5.3、完成此次提交内容，附上版本信息如下

git commit -m "initial commit"

5.4、在Github上创建好项目仓库。
在这里插入图片描述

5.5、在gitlab创建好仓库后，再与本地仓库进行关联，将项目地址进行clone，再从本地关联

git remote add origin  10.000.000.000:Junetest/test.git
# git remote add origin 服务地址+仓库git位置（点击clone地址）

5.6、再将项目推上gitlab

git push origin master

在这里插入图片描述
上传到仓库成功啦，可以在gitlab确认。

三、GitBook安装使用

1、下载地址：首先需要安装 Node.js（下载地址：https://nodejs.org/en/download/），找到对应平台的版本安装即可。
执行下列命令安装gitbook：

npm install -g gitbook-cli

2、gitbook的使用
2.1、现在要构建一本书籍，首先在本机创建一个文件夹，名字如：book，在cmd操作页面，进入book文件夹下,执行：

gitbook init

在这里插入图片描述

2.2、用Typora（markdown编辑工具也可以用其他）编辑SUMMARY.md文件，若将内容改成如下，保存：

# Summary

* [前言](README.md)
* [第一章](第一章/README.md)
  * [第一节](第一章/组件概述.md)
  * [第二节]（第一章/组件应用场景.md）
* [第二章](第二章/README.md)
  [第一节](第二章/组件优势.md)

再回到cmd命令行，执行命令， GitBook 会查找 SUMMARY.md 文件中描述的目录和文件，如果没有则会将其创建。

gitbook init``

在这里插入图片描述
2.3、再执行命令来预览这本书的网页，有提示地址为： http://localhost:4000

gitbook serve

在这里插入图片描述

2.4、写完之后，可以构建这本书籍，默认将生成的静态网站输出到 _book 目录，HTML已在gitbook serve命令执行时，已输出，其他文件输出可用下面命令。

gitbook build [书籍路径] [输出路径]

#输出pdf，需安装ebook-convert
# gitbook pdf ./ ./book.pdf

在这里插入图片描述
2.5、做git的版本管理，如下命令

git init #初始化仓库
git remote add origin 服务地址+仓库git位置

注：
暂时简单的把gitlab和gitbook结合了一下，要正常进行一个自动构建电子书管理还需要做很多事，以后有深入接触再续。