最近琢磨着测试一下bun这玩意儿,正好之前搭的vitepress站点也想重新搞一搞,今天就来给大伙分享下具体咋操作。

一、安装bun

bun的安装可以参考它的中文官网,网址是https://www.bun.sh.cn/docs/installation 。按照官网的说法,Windows系统安装bun的话,最低得是Windows 10 版本1809 。我这系统是22H2,肯定是够用了。

安装的时候,在powershell里执行这条命令就行:

powershell -c "irm bun.sh/install.ps1|iex" 

安装完成后,咱得重启下cmd或者powershell,然后输入下面这条命令检查下是否安装成功:

bun -v 1.2.5 

如果能显示出版本号,就说明安装没问题啦。

二、创建vitepress项目

1. 初始化项目

先打开vscode,新建一个blog文件夹。接着在vscode的终端里输入下面的命令,安装vitepress:

bun add -D vitepress 

我安装的时候,大概花了15.06秒。安装完成后,会有类似下面这样的提示信息:

PS E:studyBlog> bun add -D vitepress bun add v1.2.5 (013fdddc) installed vitepress@1.6.3 with binaries: - vitepress 125 packages installed [15.06s] 

2. 配置项目

安装好之后,要初始化vitepress项目,执行下面这条命令:

bun vitepress init 

这时候会弹出一系列问题,按照vitepress.dev/zh/guide/ge… 这个指南里说的来回答就行。比如像下面这样:

┌ Welcome to VitePress! │ ◇ Where should VitePress initialize the config? │ ./docs │ ◇ Where should VitePress look for your markdown files? │ ./docs │ ◇ Site title: │ My Awesome Project │ ◇ Site description: │ A VitePress Site │ ◇ Theme: │ Default Theme │ ◇ Use TypeScript for config and theme files? │ Yes │ ◇ Add VitePress npm scripts to package.json? │ Yes │ ◇ Add a prefix for VitePress npm scripts? │ Yes │ ◇ Prefix for VitePress npm scripts: │ docs │ └ Done! Now run pnpm run docs:dev and start writing. 

3. 启动项目

项目创建好之后,就可以启动看看效果啦,执行下面这条命令:

bun run docs:dev 

项目启动成功后,我就把之前写的内容替换进去,顺便测试了下HMR热更新。一顿操作下来,没发现啥问题,热更新速度也还挺快。

三、打包测试

站点能正常跑起来了,接下来测试打包和本地部署。打包的话,执行这条命令:

bun run docs:build 

执行后会有类似下面这样的输出:

$ vitepress build blog Debugger attached. vitepress v1.6.3 ✓ building client + server bundles... ✓ rendering pages... build complete in 7.17s. Waiting for the debugger to disconnect... 

打包完成后,会生成一个dist文件夹。把这个dist文件夹放到iis上进行访问测试,我这边测试下来没发现啥问题。

按照上面这些步骤,就能用bun搭建一个vitepress个人博客啦,大伙要是有兴趣,赶紧动手试试吧!