Centos7下搭建gitbook环境踩坑记录
1.安装npm
yum -y install npm
2.配置npm仓
npm config set registry https://mirrors.tencent.com/npm/
3.安装gitbook-cli和gitbook
npm install gitbook-cli -g
npm install gitbook -g
查看是否安装成功:gitbook -V
4.编译book
进入到book工程根目录,执行:gitbook build
5.启动服务gitbook serve
工程目录下执行:gitbook serve ./ --port=80
其中,--port指定端口,默认是4000
6.问题汇总
1.安装gitbook-cli时,报错TypeError: cb.apply is not a function,报错截图如下:
原因:graceful-fs兼容问题
解决办法:进入到报错提示里的目录,我这边是进入到/usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/,执行npm install graceful-fs@latest --save
,安装最新的graceful-fs
2.执行build时报错,TypeError: Cannot read property 'pipes' of undefined,报错截图如下:
原因:graceful-fs兼容问题
解决办法:同问题1,将版本指定到4.2.0(应该是某些版本有问题而已)npm install graceful-fs@4.2.0 --save
强烈建议:文件名不要有中文,尽量不要用特殊字符,避免踩坑
7.初始化脚本
#!/bin/bash
# 找不到则安装
if ! which gitbook > /dev/null 2>&1; then
echo "start init."
# 安装npm
yum -y install npm
# 配置npm源
npm config set registry https://mirrors.tencent.com/npm/
# 安装gitbook-cli和gitbook
npm install gitbook-cli -g
npm install gitbook -g
# 解决版本兼容
if which gitbook > /dev/null 2>&1; then
# npm依赖包安装路径
node_modules_path=$(npm root -g)
cd $node_modules_path/gitbook-cli/node_modules/npm/node_modules/
npm install graceful-fs@4.2.0 --save
echo "init success."
fi
fi
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· AI与.NET技术实操系列:向量存储与相似性搜索在 .NET 中的实现
· 基于Microsoft.Extensions.AI核心库实现RAG应用
· Linux系列:如何用heaptrack跟踪.NET程序的非托管内存泄露
· 开发者必知的日志记录最佳实践
· TypeScript + Deepseek 打造卜卦网站:技术与玄学的结合
· Manus的开源复刻OpenManus初探
· AI 智能体引爆开源社区「GitHub 热点速览」
· 从HTTP原因短语缺失研究HTTP/2和HTTP/3的设计差异
· 三行代码完成国际化适配,妙~啊~