前言：写好的 GitBook 文档，怎么才能免费发布到网上，让所有人都能直接访问？不用买服务器、不用懂复杂部署，借助 GitHub Pages 免费托管服务，几步就能实现，全程零成本、一步到位在线文档部署，全程鼠标操作，无需代码基础～

一、核心原理（部署逻辑）

本质特别简单：GitBook 写完文档后，会编译生成一个 _book 文件夹，这个文件夹里全是纯静态网页资源（html、css、js 等），不需要任何服务器支撑。

而 GitHub Pages 是 GitHub 提供的免费静态网页托管服务，只要把 _book内的全部的静态文件上传到 GitHub 仓库，再简单配置一下，就能自动生成公开访问的链接，任何人打开浏览器就能浏览你的 GitBook 文档。

二、完整操作（全程实操）

第1步：准备 GitHub 仓库（两种方式）

1. 场景一：基于别人的开源文档二次修改 如果是想修改、复用别人的开源 GitBook 文档，直接打开目标 GitHub 仓库，点击右上角的「Fork」按钮，一键复刻到自己的 GitHub 账号下，后续所有操作都在复刻的仓库里进行即可。

2. 场景二：从零搭建全新文档 打开 GitHub 主页，点击右上角「New repository」新建仓库，注意：不要勾选「Initialize this repository with a README」，不要添加任何许可证，保持仓库为空，点击「Create repository」完成创建。

第2步：上传本地 GitBook 静态文件（关键一步）

1. 先在本地编译 GitBook 项目：打开 GitBook 客户端，找到你的文档项目，编译完成后，会自动生成一个 _book 文件夹

2. 打开你刚才新建/复刻的 GitHub 仓库，点击页面上方的「Add file」→「Upload files」

3. 不要直接上传整个 _book 文件夹！打开本地的 _book 文件夹，选中里面的所有内容，全部拖拽到 GitHub 上传区域，确保所有文件都直接放在仓库「根目录」（不是嵌套在 _book 文件夹里）
   注意： 不要直接上传整个 _book 文件夹！
   注意： 不要直接上传整个 _book 文件夹！
   注意： 不要直接上传整个 _book 文件夹！

4. 上传完成后，下拉页面，在「Commit changes」处填写备注，点击按钮保存。

5. 在仓库根目录新建一个空白文件，文件名必须是 .nojekyll（注意前面有个英文点），内容留空，直接保存即可。作用：禁用 GitHub 自带的 Jekyll 渲染功能，避免 GitBook 文档的样式错乱、排版失效。

第3步：开启 GitHub Pages，实现全网公开访问（核心配置）

文件上传完成后，就差最后一步配置，开启托管功能，让 GitHub 帮我们生成公开链接。

1. 进入 GitHub 仓库，点击右上角的「Settings」（设置）按钮

2. 页面往下滑动，找到「Pages」选项，点击进入配置界面。

3. 按照以下配置操作（照搬即可，无需修改）：

   • Source：选择「Deploy from a branch」（从分支部署）

   • Branch：选择「main」或「master」（ _book内文件放在哪个分支用哪个）

   • Folder：选择「/ (root)」（根目录，对应我们刚才上传的静态文件位置）

4. 点击「Save」保存配置，然后耐心等待 1~3 分钟（GitHub 需要时间部署），部署完成后，页面会显示「Your site is published at XXX」，这个 XXX 就是你的公开访问链接。

第4步：获取公开链接，分享给所有人

部署生效后，你的 GitBook 文档公开访问链接是固定格式的，非常好记：

https://用户名.github.io/仓库名

举个例子：如果你的 GitHub 用户名是xxx，仓库名是gitbook-demo
那么链接就是https://xxx.github.io/gitbook-demo 复制这个链接，发给朋友、放在博客、分享到社群，任何人打开浏览器都能免费浏览，无需登录、无任何访问限制。

三、极简核心总结（快速回顾）

1. 本地 GitBook 编译，生成 _book 静态文件夹；

2. 将 _book 内部所有文件，上传到 GitHub 仓库根目录，同时添加.nojekyll 空白文件；

3. GitHub Pages 配置：选择(Deploy from a branch) + 根目录(root)，保存(save)部署；

4. 等待 1~3 分钟，获取「用户名.github.io/仓库名」的公开链接，全网可访问。

四、新手避坑提示

• 避坑1：不要上传 _book 文件夹本身，只上传里面的内容，否则会导致页面无法访问；

• 避坑2：.nojekyll 文件必须新建，且放在根目录，否则会出现样式错乱、排版异常；

• 避坑3：部署后如果无法访问，先检查文件是否在根目录、Pages 配置是否正确，等待 3 分钟后再刷新尝试（部署需要时间，去Action查看）；

• 避坑4：后续修改 GitBook 文档后，只需重新编译生成 _book 文件，重复第二步上传（覆盖原有文件），GitHub 会自动重新部署，无需再次配置 Pages。

按照这个教程操作，不管是新手还是小白，都能轻松把 GitBook 文档部署到网上，实现全网免费公开访问。如果操作中遇到问题，欢迎在评论区留言，我会一一解答～