hexo-nodejs环境配置

快速返回导航页

点击返回导航页doc-for-hexo

使用proxy-代理

您可能在中国大陆无法访问所需的资源,比如无法下载 node.js or无法安装依赖?
,于是您可能要使用代理,

但是这部分内容已经超出了本项目的范围,

话虽如此,您可以阅读这篇文章寻找解决方案:

安装一个包管理器 for Linux

您需要首先安装一个包管理器,Linux上使用n,windows上使用nvm for windows

在Linux上建议安装n,这十分简便,见:n-node.js manager

1
2
n lts
n use lts

安装一个包管理器 for Windows

您需要首先安装一个包管理器,windows上使用nvm for windows

在Windows环境使用nvm for windows:coreybutler/nvm-windows: A node.js version management utility for Windows. Ironically written in Go.

安装好nvm后,使用以下命令:

1
2
3
4
nvm ls
nvm uninstall 14.5.4
nvm install 14.5.4
nvm use 14.5.4

安装博客的所有依赖

接下来,来到博客根目录,使用安装yarn命令,众所周知,npm是一种使用体验很糟糕的包管理器,所以推荐使用yarn
使用代理,这个命令是我自定义的脚本,具体见

1
proxy_npm
1
npm i -g yarn

使用代理,这个命令是我自定义的脚本,具体见index-proxy

1
proxy_yarn

安装依赖

1
yarn install

安装node js相关依赖时出现了问题,安装了错误的node依赖,或者您遇到了未知bug

当您安装了错误的node依赖,或者您遇到了未知bug,可以尝试重新安装node依赖

linux中:使用下列命令删除node依赖

1
rm -rf node_modules/

windows中:手动删除node_modules文件夹

之后,请重新安装依赖

1
yarn install

有时可能会是您的权限问题,

1
npm WARN checkPermissions Missing write access to /usr/local/lib/node_modules

如果您使用linux系统,可以尝试添加 sudo

1
sudo npm i -g yarn

安装hexo

见官方文档:文档 | Hexo

所有必备的应用程序安装完成后,即可使用 npm 安装 Hexo。

1
npm install -g hexo-cli  

进阶安装和使用

对于熟悉 npm 的进阶用户,可以仅局部安装 hexo 包。

1
npm install hexo  

安装以后,可以使用以下两种方式执行 Hexo:

  1. npx hexo <command>
  2. 将 Hexo 所在的目录下的 node_modules 添加到环境变量之中即可直接使用 hexo <command>
1
echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile

进行环境测试

在安装好nodejs依赖后,您需要进行一次node.js依赖测试,以确保您的依赖全部安装正确

使用下面的命令,部署hexo的本地server,这能够测试你的环境是否全部安装完成,安装是否存在问题。

根据 Hexo 官网 的文档要求,我们需要初始化一个 Hexo 博客文件夹,

以博客目录 blog 为例,命令如下:

1
2
cd blog #博客根目录
yarn install

最后 hexo server 为本地运行测试服务器,来查看博客,

1
hexo clean && hexo s -debug

最后像这样便运行成功了:
w3gPZbuvC26sGIh.png

最后在本地的浏览器里面输入

1
http://localhost:5000/

便可看见 Hexo 博客样式(我们修改了默认端口为5000),打开且无报错

下面这条报错可以忽略,

1
(node:11248) [DEP0066] DeprecationWarning: OutgoingMessage.prototype._headers is deprecated

其他报错则需要自行排除bug,查看环境测试时,部署本地server失败

环境测试时,部署本地server失败

当您安装了错误的node依赖,或者您遇到了未知bug,可以尝试重新安装node依赖

linux中:使用下列命令删除node依赖

1
rm -rf node_modules/

windows中:手动删除node_modules文件夹

之后,请重新安装依赖

1
yarn install

更新项目的依赖

这种情况一般是您的依赖安装不正确,或者是您的项目依赖需要更新,亦或者您需要清理hexo生成的文件

有时,您可能需要更新项目的依赖

yarn upgrade-interactive

清理全部生成文件 hexo clean

这是排除大部分bug时使用的命令,有时候还能够解决一些报错。十分的玄学。究其原因,是糟糕的依赖安装系统导致的。

1
hexo clean

测试服务器更换了端口?

因为中国用户经常遇到端口占用问题,我更改了默认的server端口,变为了5000

hexo的默认server端口是4000,其与中国大部分软件使用的端口都冲突(主要是腾讯系,包括foxmail)

所以建议更改默认的server端口,

具体的方法如下:

每次启动server都使用指定命令

1
hexo s -p 5000 -debug

永久方法(推荐):在根目录_config.yml文件中加入配置

在根目录_config.yml文件中加入下列配置:(推荐在最后一行)(template已经配置好了)

1
2
3
4
server:
port: 5000
compress: true
header: true

某些文件夹被gitignore忽略了?

Public 这些本地部署所生成的文件夹是不用被上传的,我们的方案不需要他们,这里已经被 .gitignore 忽略了.

后面使用 Vercel 连接您的GitHub博客仓库也是不需要 Public 这类文件夹的。

结束语

到了这,您的相关环境就配置完成了,

您可以进行下一步,点击返回导航页
doc-for-hexo

对于过时的npm包管理器方法可以查看