VuePress Theme Reco 搭建博客

PPPerryPan2022-07-03techProgrammingVueWeb

VuePress Theme Reco 搭建博客

开发

安装Node.js

下载 | Node.js 中文网 (nodejs.cn)open in new window

安装yarn

npm install -g yarn

安装主题

yarn add vuepress-theme-reco  
# or
npm install vuepress-theme-reco --save-dev

theme-cli init	# Load successful, enjoy it!

cd [Dir]

yarn & npm install

npm run dev

.\README.md

  • 主页排版

.\vuepress\config.js

  • 导航栏设置

    "nav": [
    	...
    ],
    
    
  • 侧边栏好友显示设置

    "friendLink": [
    	...
    ],
    

.\blogs

  • 博客文章存放位置,可使用子文件夹进行分类等操作。

部署

打包

npm run build

新建sh文件

# 显示错误
set -e

# 进入打包出来的文件夹
cd ./public

git init
git add -A
git commit -m '--first commit'

# 发布地址
git push -f git@github.com:<USERNAME>/<REPO>.git master:gh-pages

cd -

常见异常

  • npm install -g yarn报错
    • 无需理会:

常见异常1

  • 部署后显示异常,F12查看Network状态一堆404
    • 确保GitHub项目名称为 <username>.github.io,否则 npm run build 时可能无法正确定位相对路径,导致后续无法找到部分文件。
Last Updated 4/13/2026, 2:35:35 PM