hexo-nodejs环境配置
快速返回导航页
点击返回导航页doc-for-hexo
使用proxy-代理
您可能在中国大陆无法访问所需的资源,比如无法下载 node.js or无法安装依赖?
,于是您可能要使用代理,
但是这部分内容已经超出了本项目的范围,
安装一个包管理器 for Linux
您需要首先安装一个包管理器,Linux上使用n,windows上使用nvm for windows
在Linux上建议安装n,这十分简便,见:n-node.js manager
1 | n 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 | nvm ls |
安装博客的所有依赖
接下来,来到博客根目录,使用安装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:
npx hexo <command>
- 将 Hexo 所在的目录下的
node_modules
添加到环境变量之中即可直接使用hexo <command>
:
1 | echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile |
进行环境测试
在安装好nodejs依赖后,您需要进行一次node.js依赖测试,以确保您的依赖全部安装正确
使用下面的命令,部署hexo的本地server,这能够测试你的环境是否全部安装完成,安装是否存在问题。
根据 Hexo 官网 的文档要求,我们需要初始化一个 Hexo 博客文件夹,
以博客目录 blog
为例,命令如下:
1 | cd blog #博客根目录 |
最后 hexo server
为本地运行测试服务器,来查看博客,
1 | hexo clean && hexo s -debug |
最后像这样便运行成功了:
最后在本地的浏览器里面输入
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 | server: |
某些文件夹被gitignore忽略了?
Public
这些本地部署所生成的文件夹是不用被上传的,我们的方案不需要他们,这里已经被 .gitignore
忽略了.
后面使用 Vercel
连接您的GitHub博客仓库也是不需要 Public
这类文件夹的。
结束语
到了这,您的相关环境就配置完成了,
您可以进行下一步,点击返回导航页
doc-for-hexo