You need to enable JavaScript to run this app. 无Vue CLI的Vue3最小化npm项目搭建咨询(支持TS、SFC)
优惠活动
大模型
产品
解决方案
定价
更多

无Vue CLI的Vue3最小化npm项目搭建咨询(支持TS、SFC)

无Vue CLI的Vue3最小规范项目配置方案

适用场景说明

这套配置完全匹配需求边界:

  • 不依赖Vue CLI,所有配置逻辑透明无黑盒封装,参考了Vue官方给出的安装指引提示——不建议尚未熟悉Node.js构建工具的初学者直接从封装较重的Vue CLI入手
  • 完整支持TypeScript语法、Vue单文件组件(.vue)
  • 面向Chrome 87+、Electron环境,不引入任何polyfill、语法降级逻辑
  • 配置轻量化,和此前使用<script>标签直接引入Vue的开发思路衔接顺畅,没有过高的学习门槛

项目初始化步骤

  • 新建空项目文件夹,在终端执行npm init -y生成基础package.json文件
  • 安装最小化的依赖集合,无冗余包:
    • 生产依赖:仅需安装vue@^3.4即可,不需要额外引入运行时兼容包
    • 开发依赖:
      • vite@^5:原生基于ESM的构建工具,对Chrome 87+环境零转译开销
      • @vitejs/plugin-vue:Vite官方提供的单文件组件编译插件,无多余逻辑
      • typescript、vue-tsc:提供TS语法支持、单文件组件的TS类型检查能力

说明:由于目标环境原生支持ES2020+语法、ES Module,完全不需要安装Babel、core-js等兼容类工具

核心配置文件最小集

Vite配置(vite.config.ts)

仅保留必要配置,关闭所有polyfill、降级逻辑,适配Electron的资源路径要求:

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

export default defineConfig({
  plugins: [vue()],
  build: {
    // 直接指定构建目标为Chrome 87,Vite会自动关闭所有低于目标版本的语法降级、polyfill注入
    target: 'chrome87',
    // 按需关闭sourcemap减小包体积
    sourcemap: false
  },
  // 相对路径配置,适配Electron的file://协议加载场景
  base: './'
})

TypeScript配置(tsconfig.json)

采用Vue3生态推荐的最小配置,无冗余选项:

{
  "compilerOptions": {
    "target": "ES2020",
    "useDefineForClassFields": true,
    "module": "ESNext",
    "moduleResolution": "bundler",
    "strict": true,
    "jsx": "preserve",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "esModuleInterop": true,
    "lib": ["ES2020", "DOM", "DOM.Iterable"],
    "skipLibCheck": true,
    "noEmit": true
  },
  "include": ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.tsx", "src/**/*.vue"]
}

类型声明文件(src/vite-env.d.ts)

用于让TypeScript识别.vue单文件组件、Vite提供的特殊导入能力,内容仅需1行:

/// <reference types="vite/client" />

最小项目目录结构

项目根目录/
├── index.html          # 页面入口
├── package.json
├── tsconfig.json
├── vite.config.ts
└── src/
    ├── main.ts         # JS/TS入口逻辑
    ├── App.vue         # 根单文件组件
    └── vite-env.d.ts   # 类型声明文件

各入口文件最小内容

index.html

和此前直接引入script标签的页面结构完全一致,仅需指向TS入口:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Vue3最小项目</title>
</head>
<body>
  <div id="app"></div>
  <script type="module" src="/src/main.ts"></script>
</body>
</html>

src/main.ts

核心挂载逻辑和此前script引入Vue的写法完全一致,仅需将Vue导入换成npm模块形式:

import { createApp } from 'vue'
import App from './App.vue'

createApp(App).mount('#app')

src/App.vue

直接使用<script setup lang="ts">语法即可编写带TS支持的单文件组件,无需额外配置:

<script setup lang="ts">
const msg = '最小配置的Vue3项目可直接运行'
</script>

<template>
  <h1>{{ msg }}</h1>
</template>

可直接使用的脚本配置

在package.json的scripts字段中配置三个基础脚本,覆盖开发、构建、预览场景:

{
  "scripts": {
    "dev": "vite",
    "build": "vue-tsc && vite build",
    "preview": "vite preview"
  }
}

内容的提问来源于stack exchange,提问作者Xinchao

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 09:15:04