引言

VuePress 是一个基于 Vue 的静态站点生成器,它可以帮助开发者快速搭建和部署 Vue 3 项目。本文将带领新手一步步学习如何使用 VuePress 打包 Vue 3 项目,使其能够顺利部署到服务器或静态网站托管平台。

一、环境准备

在开始之前,请确保您的开发环境已经满足以下要求:

  1. Node.js 和 npm:VuePress 需要 Node.js 和 npm,可以从 下载并安装。
  2. Vue CLI:VuePress 需要借助 Vue CLI 来创建项目,请确保您已经安装了 Vue CLI。

二、创建 VuePress 项目

  1. 打开终端或命令行,执行以下命令创建新的 VuePress 项目:
vue create my-vuepress-project

    在弹出的交互式命令行中,选择默认设置或根据自己的需求进行配置。

    创建完成后,进入项目目录:

cd my-vuepress-project

三、配置 VuePress

  1. 修改 config.js 文件,进行项目配置。以下是一些常用的配置选项:
module.exports = {
  title: 'VuePress 实战指南',
  description: 'VuePress 轻松打包 Vue 3',
  head: [
    ['link', { rel: 'icon', href: '/logo.png' }],
  ],
  themeConfig: {
    nav: [
      { text: 'Home', link: '/' },
      { text: 'Guide', link: '/guide/' },
    ],
    sidebar: {
      '/guide/': [
        {
          title: 'Guide',
          collapsable: false,
          children: [''],
        },
      ],
    },
  },
};
  1. 如果需要使用插件,请参考 ,并在 config.js 中进行配置。

四、编写 Vue 3 代码

  1. 在项目目录下,创建一个名为 src 的文件夹,用于存放 Vue 3 代码。
  2. src 文件夹中,创建一个名为 App.vue 的文件,并编写如下代码:
<template>
  <div>
    <h1>Hello VuePress!</h1>
  </div>
</template>

<script>
export default {
  name: 'App',
};
</script>

<style>
h1 {
  color: #42b983;
}
</style>
  1. src 文件夹中,创建一个名为 main.js 的文件,并编写如下代码:
import Vue from 'vue';
import App from './App.vue';

new Vue({
  render: h => h(App),
}).$mount('#app');

五、启动 VuePress 项目

  1. 在终端或命令行中,执行以下命令启动 VuePress 项目:
npm run dev
  1. 打开浏览器,访问 http://localhost:8080/,您将看到如下页面:

六、打包 VuePress 项目

  1. 在终端或命令行中,执行以下命令打包 VuePress 项目:
npm run build
  1. 打包完成后,项目生成的静态文件将位于 .vuepress/dist 目录下。

七、部署 VuePress 项目

  1. .vuepress/dist 目录下的文件上传到您的服务器或静态网站托管平台。
  2. 根据平台的指引,配置域名和 SSL 证书(如果需要)。

总结

通过本文的介绍,您应该能够轻松使用 VuePress 打包 Vue 3 项目,并将其部署到服务器或静态网站托管平台。祝您在 VuePress 之旅中一切顺利!