跳到主要内容

环境配置

切换 Node 版本

如果你还没安装 Node,或者不需要灵活切换 Node 版本,可直接**下载**固定版本进行安装

Docusaurus 的要求是 v16.14 以上的版本,之前在部署 Hexo 的时候安装的是 v12.19 的版本,所以我得更换 Node.js 的版本,考虑 Node.js 的版本不一定是固定的,所以我选择用 nvm 来管理 Node 版本,这里参考了一位博主的教程,详情见[参考链接]。

卸载已安装的 Node 版本

在安装 nvm 之前,需要将已安装的 Node 进行卸载,步骤如下:

Step 1Node.js 程序卸载

Step 2 从下列目录中找到先关内容并删除掉

Step 3 重启电脑

安装 nvm

选择的是 Windows 系统,如果是 Linux 或者其他系统会有出入,请自行查找。

进入项目地址找到并下载安装包

安装完成后执行以下命令可查看可安装的 Node.js 版本

nvm list available 

install 之前,先配置成淘宝镜像安装 npm,在 nvm 的安装路径:nvm/setting:

root: E:\Blog\nvm\nvm
path: E:\Blog\Nodejs
arch: 64
proxy: none
originalpath: .
originalversion:
//配置淘宝镜像
node_mirror: https://npm.taobao.org/mirrors/node/
npm_mirror: https://npm.taobao.org/mirrors/npm/

这个方法不一定有效,详情请移步参考链接

还要特别注意!Node 的下载目录里一定要是个空文件夹!不然会出问题! 然后安装指定版本的 Node.js,这里根据 Docusaurus 的要求得安装 v16.14 以上版本,执行命令

nvm install 17.9.1 64-bit

安装完成后可以执行命令 nvm list 来查看已安装的版本 。如果有需要也可以继续安装其他版本。这里我把之前搭 Hexo 时安装的 v12.19 版本安装回来测试一下

使用指定版本的 Node.js

nvm use 版本号

删除指定版本的 Node.js

nvm uninstall 版本号

安装 Yarn

yarn 是我参考的博主比较推荐的,当然你也可以使用 npm,就无需进行此步骤。

前往官网,注意这里使用的不是 2.x 版本,是 1.x 版本。

点击官网的安装 Yarn,并通过以下命令进行安装

检查安装是否成功

yarn --version

或者可以选择下载安装包的方式进项安装,不过中文网站的下载链接失效了,得去英文网站进行下载,下载后一步步安装即可。

安装 Docusaurus

这里我是直接 fork 了愧怍博主的仓库,就省去了初始化安装的过程,如果想从基础开始搭建,可以参考官方文档

特别注意的是要先安装号 Python 环境,建议 3.7/3.8,不行的话还得装 2.7

cd blog目录
yarn
yarn start

指令执行完毕且没有报错就可以本地运行啦!

参考与致谢