从零开始的＜vue2项目脚手架＞搭建：vite+vue2+eslint

前言

为了写 demo 或者研究某些问题，我经常需要新建空项目。每次搭建项目都要从头配置，很麻烦。所以我决定自己搭建一个项目初始化的脚手架（取名为 lily-cli）。

脚手架（scaffolding）：创建项目时，自动完成的创建初始文件等初始化工作。这些工作往往是每次新建工程都要进行的重复性工作。

目标：我只需要执行 npm init lily-cli，就会自动创建一个符合我要求（即 vite+vue2+eslint）的空项目。

碎碎念：

现在 vue3 是主主主主流。我作为一个不得不使用 vue2 的开发者，在 vue3 浪潮下想要搜索 vue2 的内容真的有一点点麻烦------比如说，vite 已经不提供 vue2 的官方初始化模板了，而 vite 的社区模板也没有适合我的，所以我还是自己搭建一个吧。

分成两步实现：

手动创建一个集成 vite+vue2+eslint 的项目
以上一步的项目作为模板，让程序自动创建新项目

Step 1：手动创建项目 vite+vue2+eslint

初始化

新建文件夹 template_vite_vue2_eslint
npm init -y

vite + vue2

在 vite 中使用 vue2.7+，要用 @vitejs/plugin-vue2。这个插件已经不再更新了，安装时可以直接锁定最新版本 2.3.1。

vite 和 vue 的版本要看 @vitejs/plugin-vue2 的要求：

json 复制代码

// @vitejs/plugin-vue2 最新版本的 package.json
  "peerDependencies": {
    "vite": "^3.0.0 || ^4.0.0 || ^5.0.0",
    "vue": "^2.7.0-0"
  },

pnpm i vite@"^5.0.0" vue@"^2.7.0" @vitejs/plugin-vue2@2.3.1

在 package.json 中添加 scripts：

js 复制代码

  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "preview": "vite preview"
  },

新建 vite.config.js：

js 复制代码

import vue from '@vitejs/plugin-vue2'

export default {
  plugins: [vue()]
}

创建 main.js 等文件

js 复制代码

// src/main.js
import Vue from "vue";
import App from "./App.vue";

Vue.config.productionTip = false;
Vue.config.devtools = true;

new Vue({
  el: "#app",
  render: (h) => h(App),
});

html 复制代码

// src/App.vue
<template>
  <section>
    {{ message }}
  </section>
</template>

<script setup>
import { ref } from "vue";
const message = ref("模板");
</script>

html 复制代码

// index.html
<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Vite + Vue</title>
  </head>
  <body>
    <div id="app"></div>
    <script type="module" src="/src/main.js"></script>
  </body>
</html>

eslint

配置 eslint npm init @eslint/config@latest

如有问题可参考《vscode 中 eslint 无效？npm init 是什么？》

Step 2：搭建脚手架，让一切自动化

在前言中说了，我的目标是 "执行 npm init lily-cli，就会自动创建项目"。所以有必要了解一下 npm init 这个命令

npm init

点这里查看 npm init 官方文档

npm init 有两种用法：

npm init 在一连串问题后，根据你的回答自动创建 package.json 文件。-y 可以跳过问题
npm init <initializer>：根据指定的 initializer 初始化项目。通过 npx 安装 create-<initializer> 包并执行它的 bin。