Skip to main content

环境配置

切换 Node 版本​

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

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

卸载已安装的 Node 版本​

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

Step 1 将 Node.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

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

参考与致谢​