unplugin-vue 安装与配置指南

unplugin-vue 安装与配置指南

unplugin-vue ✨ Transform Vue 3 SFC to JavaScript. Supports Vite, esbuild, Rollup, Webpack and more. 项目地址: https://gitcode.com/gh_mirrors/un/unplugin-vue

1. 项目基础介绍

unplugin-vue 是一个用于将 Vue 3 单文件组件（SFC）转换为 JavaScript 的工具。它支持多种构建系统，包括 Vite、Webpack、Vue CLI、Rollup 和 esbuild。此项目主要使用 TypeScript 编写，提供了一套统一的插件系统，可以方便地在不同的构建工具中使用。

2. 项目使用的关键技术和框架

• unplugin: unplugin 是一个统一的插件系统，可以适配 Vite、Webpack、Rollup 等多种构建工具。
• Vue 3: unplugin-vue 专门为 Vue 3 设计，支持最新的 Vue 3 特性，如 <script setup> 和宏。
• TypeScript: 项目使用 TypeScript 进行类型安全的开发。

3. 项目安装和配置的准备工作

在开始安装 unplugin-vue 之前，请确保您的开发环境中已经安装了以下依赖：

• Node.js (推荐使用 LTS 版本)
• npm 或 yarn 包管理器

详细安装步骤

步骤 1: 初始化项目

首先，创建一个新的目录作为项目文件夹，然后在该目录下打开终端或命令行窗口。

mkdir my-vue-project
cd my-vue-project

接下来，初始化一个新的 npm 项目：

npm init -y

步骤 2: 安装 unplugin-vue

安装 unplugin-vue 之前，需要先安装 unplugin：

npm install unplugin

然后，安装 unplugin-vue：

npm install unplugin-vue

步骤 3: 配置构建工具

根据您选择的构建工具，配置 unplugin-vue。以下是一些常见构建工具的配置示例：

Vite

如果使用 Vite，可以在 vite.config.js 文件中添加 unplugin-vue 插件：

import { defineConfig } from 'vite'
import vue from 'unplugin-vue/vite'

export default defineConfig({
  plugins: [vue()]
})

Webpack

如果使用 Webpack，可以在 webpack.config.js 文件中配置：

const { VueLoaderPlugin } = require('vue-loader')
const { default: vue } = require('unplugin-vue/webpack')

module.exports = {
  // ... 其他配置
  module: {
    rules: [
      // ... 其他规则
      {
        test: /\.vue$/,
        loader: 'vue-loader'
      }
    ]
  },
  plugins: [
    new VueLoaderPlugin(),
    vue()
  ]
}

Rollup

如果使用 Rollup，可以在 rollup.config.js 文件中配置：

import vue from 'unplugin-vue/rollup'

export default {
  // ... 其他配置
  plugins: [vue()]
}

步骤 4: 创建 Vue 组件

现在，您可以开始创建 Vue 组件了。例如，创建一个简单的 .vue 文件：

<template>
  <div>Hello, World!</div>
</template>

<script setup>
console.log('Vue 3 component with <script setup>')
</script>

步骤 5: 构建和运行项目

根据您的构建工具，运行构建命令，然后启动开发服务器。

例如，如果使用 Vite，可以运行：

npm run dev

这将会启动一个开发服务器，并且在浏览器中打开一个新标签页，您应该可以看到您的 Vue 应用。

以上步骤即为 unplugin-vue 的基本安装和配置指南。如果您遇到任何问题，请查阅项目的官方文档或向社区寻求帮助。

unplugin-vue ✨ Transform Vue 3 SFC to JavaScript. Supports Vite, esbuild, Rollup, Webpack and more. 项目地址: https://gitcode.com/gh_mirrors/un/unplugin-vue