VitePress+GitHub Pages

（一）工具准备

git，下载地址：https://git-scm.com/

nodejs，下载地址：https://nodejs.org/en/

yarn，下载地址：https://github.com/yarnpkg/yarn/releases

额外工具：

VSCode，下载地址：https://code.visualstudio.com/

Typora，旧版本：typora-setup-x64_0.9.78 （此旧版本，免费使用，无需破解）

（二）环境准备

参考资料：https://vitepress.dev/guide/getting-started

命令均为右键选择“Git Bash Here”打开CLI界面键入

2.1 手动新建一个文件

mkdir vitepress-starter && cd vitepress-starter

2.2 初始化文件

yarn init

2.3 安装：

yarn add -D vitepress

2.4 启动本地预览服务：

yarn docs:dev

2.5 github 访问配置

打开 C:\Windows\System32\drivers\etc\hosts 文件追加如下内容

20.205.243.166  github.com
108.160.169.186  github.global.ssl.fastly.net
20.205.243.166 assets-cdn.github.com

（三）VitePress主题配置

（四）部署到GitHub

在myblog文件夹内新建deploy.sh脚本文件，内容如下：

 #！/usr/bin/bash

# 忽略错误
 set -e

#  构建
 yarn docs:build

 # 新增CNAME文件
 echo "linuxdoc.com" > docs/.vitepress/dist/CNAME

# 进入待发布的目录
 cd docs/.vitepress/dist

# git init 第一次部署需要，后续部署需要注释掉

 git add -A
 git commit -m 'deploy'

# 如果部署到 https://<USERNAME>.github.io
 git push -f https://github.com/peiyafei/peiyafei.github.io.git

# cd -

给脚本添加执行权限：

$ chmod u+x deploy.sh

执行脚本：

在myblog目录下执行脚本：

$ pwd
/c/myblog/myblog

$ bash deploy.sh

（五）阿里云域名配置

（六）检查GitHub Pages配置

（七）验证网站

（八）升级vitepress

1. 通过chatgpt询问当前vitepress最新版本

2. 在vitepress项目根目录，地址栏执行以下命令

 cmd

1. 命令查询当前版本，或查询项目的 package.json 文件

npm list vitepress

1. 升级项目中所有依赖包到最新版本

yarn upgrade --latest

故障集合解决方案

1. 提示

fatal:unable to access ‘https://github.com/.../.git

解决方案：

//取消http代理
git config --global --unset http.proxy
//取消https代理 
git config --global --unset https.proxy