hexo-nodejs环境配置
快速返回导航页
点击返回导航页doc-for-hexo
使用proxy-代理
您可能在中国大陆无法访问所需的资源,比如无法下载 node.js or无法安装依赖? ,于是您可能要使用代理,
但是这部分内容已经超出了本项目的范围,
安装一个包管理器 for Linux
您需要首先安装一个包管理器,Linux上使用n,windows上使用nvm for windows
在Linux上建议安装n,这十分简便,见:n-node.js manager
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后,使用以下命令:
nvm ls
nvm uninstall 14.5.4
nvm install 14.5.4
nvm use 14.5.4
安装博客的所有依赖
接下来,来到博客根目录,使用安装yarn命令,众所周知,npm是一种使用体验很糟糕的包管理器,所以推荐使用yarn 使用代理,这个命令是我自定义的脚本,具体见
proxy_npm
npm i -g yarn
使用代理,这个命令是我自定义的脚本,具体见index-proxy
proxy_yarn
安装依赖
yarn install
安装node js相关依赖时出现了问题,安装了错误的node依赖,或者您遇到了未知bug
当您安装了错误的node依赖,或者您遇到了未知bug,可以尝试重新安装node依赖
linux中:使用下列命令删除node依赖
rm -rf node_modules/
windows中:手动删除node_modules文件夹
之后,请重新安装依赖
yarn install
有时可能会是您的权限问题,
npm WARN checkPermissions Missing write access to /usr/local/lib/node_modules
如果您使用linux系统,可以尝试添加 sudo
sudo npm i -g yarn
安装hexo
见官方文档:文档 | Hexo
所有必备的应用程序安装完成后,即可使用 npm 安装 Hexo。
npm install -g hexo-cli
进阶安装和使用
对于熟悉 npm 的进阶用户,可以仅局部安装 hexo
包。
npm install hexo
安装以后,可以使用以下两种方式执行 Hexo:
npx hexo <command>
- 将 Hexo 所在的目录下的
node_modules
添加到环境变量之中即可直接使用hexo <command>
:
echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile
进行环境测试
在安装好nodejs依赖后,您需要进行一次node.js依赖测试,以确保您的依赖全部安装正确
使用下面的命令,部署hexo的本地server,这能够测试你的环境是否全部安装完成,安装是否存在问题。
根据 Hexo 官网 的文档要求,我们需要初始化一个 Hexo 博客文件夹,
以博客目录 blog
为例,命令如下:
cd blog #博客根目录
yarn install
最后 hexo server
为本地运行测试服务器,来查看博客,
hexo clean && hexo s -debug
最后像这样便运行成功了:
最后在本地的浏览器里面输入
http://localhost:5000/
便可看见 Hexo 博客样式(我们修改了默认端口为5000),打开且无报错
下面这条报错可以忽略,
(node:11248) [DEP0066] DeprecationWarning: OutgoingMessage.prototype._headers is deprecated
其他报错则需要自行排除bug,查看环境测试时,部署本地server失败
环境测试时,部署本地server失败
当您安装了错误的node依赖,或者您遇到了未知bug,可以尝试重新安装node依赖
linux中:使用下列命令删除node依赖
rm -rf node_modules/
windows中:手动删除node_modules文件夹
之后,请重新安装依赖
yarn install
更新项目的依赖
这种情况一般是您的依赖安装不正确,或者是您的项目依赖需要更新,亦或者您需要清理hexo生成的文件
有时,您可能需要更新项目的依赖
yarn upgrade-interactive
清理全部生成文件 hexo clean
这是排除大部分bug时使用的命令,有时候还能够解决一些报错。十分的玄学。究其原因,是糟糕的依赖安装系统导致的。
hexo clean
测试服务器更换了端口?
因为中国用户经常遇到端口占用问题,我更改了默认的server端口,变为了5000
hexo的默认server端口是4000
,其与中国大部分软件使用的端口都冲突(主要是腾讯系,包括foxmail)
所以建议更改默认的server端口,
具体的方法如下:
每次启动server都使用指定命令
hexo s -p 5000 -debug
永久方法(推荐):在根目录_config.yml文件中加入配置
在根目录_config.yml文件中加入下列配置:(推荐在最后一行)(template已经配置好了)
server:
port: 5000
compress: true
header: true
某些文件夹被gitignore忽略了?
Public
这些本地部署所生成的文件夹是不用被上传的,我们的方案不需要他们,这里已经被 .gitignore
忽略了.
后面使用 Vercel
连接您的GitHub博客仓库也是不需要 Public
这类文件夹的。
结束语
到了这,您的相关环境就配置完成了,
您可以进行下一步,点击返回导航页 doc-for-hexo