跳到主要内容

环境配置

切换 Node 版本

提示

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

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

卸载已安装的 Node 版本

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

Step 1Node.js 程序卸载

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

Step 3 重启电脑

安装 nvm

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

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

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

nvm list available 

20230124235246

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 版本安装回来测试一下

20230124235657

20230124235712

使用指定版本的 Node.js

nvm use 版本号

1673270211920-e464ce1b-cffd-4ac3-a1b9-4e8b18a6c24e

删除指定版本的 Node.js

nvm uninstall 版本号

1673270222169-1665cbeb-0fb5-4532-a12f-255a4ef0f584

安装 Yarn

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

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

20230125000313

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

检查安装是否成功

yarn --version

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

安装 Docusaurus

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

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

安装完成后进行下一步,以管理员打开 PowerShell,执行如下命令

npm install --global --production windows-build-tools

最后开始 Docusaurus 正题

cd blog目录
yarn
yarn start
提示

如果报错

yarn : 无法加载文件 C:\App\Nodejs\yarn.ps1,因为在此系统上禁止运行脚本。有关详细信息,请参阅 https:/go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。

以管理员身份运行 PowerShell

set-ExecutionPolicy RemoteSigned
# Y

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

参考与致谢