无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
相关产品推荐
相关产品推荐

