create-vite-vue 2.0.0 → 2.1.1

package/bin/index.js

@@ -6,7 +6,7 @@ import { fileURLToPath } from 'url'
 
 // === 导入模块 ===
 import { cleanMainFile } from '../lib/cleanMain.js'
-import { parseExtraPlugins, parseFeatures } from '../lib/features.js'
+import { parsePlugins } from '../lib/features.js'
 import { generatePackageJson } from '../lib/package.js'
 import { setupPlugins } from '../lib/plugins/index.js'
 import { askAutoRoute, askRunDev, chooseFeatures, chooseLanguage, getProjectName } from '../lib/prompts.js'
@@ -32,13 +32,12 @@ const requiredVersion = '22.19.0'
     // 4. 选择功能
     const featureList = await chooseFeatures()
 
-    // 5. 解析功能
-    const features = parseFeatures(featureList)
-    const extraPlugins = parseExtraPlugins(featureList)
-    const enableHttps = featureList.includes('https') || false
+    // 5. 解析插件
+    const plugins = parsePlugins(featureList)
+    const enableHttps = plugins.https
 
     // 6. 询问自动路由
-    const autoRoute = await askAutoRoute(features.router)
+    const autoRoute = await askAutoRoute(plugins.router)
 
     // 7. 询问是否运行 dev
     const pkgManager = detectPackageManager()
@@ -55,7 +54,7 @@ const requiredVersion = '22.19.0'
     await updateIndexHtml(projectName, targetDir)
 
     // 10. 配置插件，并获取已使用的占位符
-    const unusedPlaceholders = await setupPlugins(features, extraPlugins, {
+    const unusedPlaceholders = await setupPlugins(plugins, {
       language,
       targetDir,
       autoRoute,
@@ -67,7 +66,7 @@ const requiredVersion = '22.19.0'
     await cleanMainFile(language, targetDir, unusedPlaceholders)
 
     // 12. 生成 package.json
-    await generatePackageJson(projectName, features, extraPlugins, autoRoute, enableHttps, language, targetDir, pkgManager)
+    await generatePackageJson(projectName, plugins, autoRoute, enableHttps, language, targetDir, pkgManager)
 
     // 13. 安装依赖
     console.log('\n📦 正在安装依赖...')

package/lib/cleanMain.js

@@ -3,6 +3,12 @@ import { existsSync } from 'fs'
 import fs from 'fs/promises'
 import path from 'path'
 
+/**
+ * 清理 main 文件中未使用的占位符
+ * @param {'ts' | 'js'} language - 项目语言
+ * @param {string} targetDir - 目标项目目录路径
+ * @param {UnusedPlaceholders} unusedPlaceholders - 未使用的占位符集合
+ */
 export async function cleanMainFile (language, targetDir, unusedPlaceholders) {
   const mainFile = language === 'ts' ? 'main.ts' : 'main.js'
   const mainPath = path.join(targetDir, `src/${mainFile}`)
@@ -31,6 +37,11 @@ export async function cleanMainFile (language, targetDir, unusedPlaceholders) {
   console.log('  🧹 已清理未使用的占位符')
 }
 
+/**
+ * 转义正则表达式中的特殊字符
+ * @param {string} str - 需要转义的字符串
+ * @returns {string} 转义后的字符串
+ */
 function escapeRegExp (str) {
   return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
 }

package/lib/features.js

@@ -1,13 +1,30 @@
 // lib/features.js
-export function parseFeatures (featureList) {
+/**
+ * 解析功能列表为插件配置对象
+ * @param {string[]} featureList - 选择的功能列表，如 ['router', 'pinia']
+ * @returns {PluginsConfig} 插件配置对象
+ */
+export function parsePlugins (featureList) {
   return {
+    // 核心插件
     router: featureList.includes('router'),
     pinia: featureList.includes('pinia'),
     axios: featureList.includes('axios'),
-    ui: featureList.filter(v => ['element', 'vant'].includes(v))
-  }
-}
 
-export function parseExtraPlugins (featureList) {
-  return featureList.filter(v => ['vueuse', 'lodash', 'dayjs', 'tailwind', 'mitt', 'https'].includes(v))
+    // UI 插件
+    elementPlus: featureList.includes('element'),
+    vant: featureList.includes('vant'),
+
+    // 工具插件
+    vueuse: featureList.includes('vueuse'),
+    lodash: featureList.includes('lodash'),
+    dayjs: featureList.includes('dayjs'),
+    mitt: featureList.includes('mitt'),
+
+    // 样式插件
+    tailwind: featureList.includes('tailwind'),
+
+    // 开发工具
+    https: featureList.includes('https')
+  }
 }

package/lib/package.js

@@ -3,7 +3,17 @@ import { existsSync } from 'fs'
 import fs from 'fs/promises'
 import path from 'path'
 
-export async function generatePackageJson (projectName, features, extraPlugins, autoRoute, enableHttps, language, targetDir, pkgManager) {
+/**
+ * 生成 package.json 文件
+ * @param {string} projectName - 项目名称
+ * @param {PluginsConfig} plugins - 插件配置对象
+ * @param {boolean} autoRoute - 是否启用自动路由
+ * @param {boolean} enableHttps - 是否启用 HTTPS
+ * @param {'ts' | 'js'} language - 项目语言
+ * @param {string} targetDir - 目标目录
+ * @param {PackageManager} pkgManager - 包管理器类型
+ */
+export async function generatePackageJson (projectName, plugins, autoRoute, enableHttps, language, targetDir, pkgManager) {
   const pkgPath = path.join(targetDir, 'package.json')
 
   if(!existsSync(pkgPath)) {
@@ -12,33 +22,31 @@ export async function generatePackageJson (projectName, features, extraPlugins,
 
   let pkgContent = await fs.readFile(pkgPath, 'utf-8')
 
-  // 收集可选依赖
   const optionalDeps = {}
 
-  if(features.router) optionalDeps['vue-router'] = '^5.0.3'
-  if(features.pinia) {
+  if(plugins.router) optionalDeps['vue-router'] = '^5.0.3'
+  if(plugins.pinia) {
     optionalDeps['pinia'] = '^3.0.4'
     optionalDeps['pinia-plugin-persistedstate'] = '^4.7.1'
   }
-  if(features.axios) optionalDeps['axios'] = '^1.13.6'
-  if(features.ui.includes('element')) {
+  if(plugins.axios) optionalDeps['axios'] = '^1.13.6'
+  if(plugins.elementPlus) {
     optionalDeps['element-plus'] = '^2.13.5'
     optionalDeps['@element-plus/icons-vue'] = '^2.3.2'
   }
-  if(features.ui.includes('vant')) optionalDeps['vant'] = '^4.9.22'
-  if(extraPlugins.includes('vueuse')) optionalDeps['@vueuse/core'] = '^14.2.1'
-  if(extraPlugins.includes('dayjs')) optionalDeps['dayjs'] = '^1.11.20'
-  if(extraPlugins.includes('lodash')) optionalDeps['lodash'] = '^4.17.23'
-  if(extraPlugins.includes('tailwind')) {
+  if(plugins.vant) optionalDeps['vant'] = '^4.9.22'
+  if(plugins.vueuse) optionalDeps['@vueuse/core'] = '^14.2.1'
+  if(plugins.dayjs) optionalDeps['dayjs'] = '^1.11.20'
+  if(plugins.lodash) optionalDeps['lodash'] = '^4.17.23'
+  if(plugins.tailwind) {
     optionalDeps['tailwindcss'] = '^4.2.2'
     optionalDeps['@tailwindcss/postcss'] = '^4.2.2'
     optionalDeps['postcss'] = '^8.5.8'
   }
-  if(extraPlugins.includes('mitt')) optionalDeps['mitt'] = '^3.0.1'
+  if(plugins.mitt) optionalDeps['mitt'] = '^3.0.1'
   if(enableHttps) optionalDeps['vite-plugin-mkcert'] = '^1.17.10'
   if(autoRoute) optionalDeps['vite-plugin-pages'] = '^0.33.3'
 
-  // 构建依赖字符串
   const depsKeys = Object.keys(optionalDeps)
   let depsStr = ''
 
@@ -46,15 +54,12 @@ export async function generatePackageJson (projectName, features, extraPlugins,
     depsStr = ',\n' + depsKeys.map(k => `    "${k}": "${optionalDeps[k]}"`).join(',\n')
   }
 
-  // 替换占位符
   pkgContent = pkgContent.replace('__PROJECT_NAME__', projectName)
   pkgContent = pkgContent.replace('__OPTIONAL_DEP__', depsStr)
 
-  // 解析并重新格式化 JSON
   const pkgObj = JSON.parse(pkgContent)
 
-  // pnpm 特殊配置
-  if(pkgManager === 'pnpm' && features.ui.includes('vant')) {
+  if(pkgManager === 'pnpm' && plugins.vant) {
     pkgObj.pnpm = { overrides: { "@vant/use": "^1.0.0", "@vant/popperjs": "^1.0.0" } }
   }
 

package/lib/plugins/autoRoute.js

@@ -3,6 +3,11 @@ import { existsSync } from 'fs'
 import fs from 'fs/promises'
 import path from 'path'
 
+/**
+ * 设置自动路由（vite-plugin-pages）
+ * @param {'ts' | 'js'} language - 项目语言
+ * @param {string} targetDir - 目标目录
+ */
 export async function setupAutoRoute (language, targetDir) {
   console.log('  🚀 配置自动路由...')
 

package/lib/plugins/axios.js

@@ -1,19 +1,17 @@
 // lib/plugins/axios.js
-import { existsSync } from 'fs'
-import fs from 'fs/promises'
-import path from 'path'
+import { copyTemplate } from '../utils'
 
+/**
+ * 配置 Axios
+ * @param {'ts' | 'js'} language - 项目语言
+ * @param {string} targetDir - 目标目录
+ * @param {string} __dirname - 当前模块目录路径
+ */
 export async function setupAxios (language, targetDir, __dirname) {
   console.log('  🌐 配置 Axios...')
 
   // 复制模板
   const axiosTemplate = language === 'ts' ? 'axios-ts' : 'axios-js'
-  const templatePath = path.resolve(__dirname, `../template/${axiosTemplate}`)
-
-  if(!existsSync(templatePath)) {
-    throw new Error(`模板不存在: ${templatePath}`)
-  }
-
-  await fs.cp(templatePath, targetDir, { recursive: true })
+  await copyTemplate(axiosTemplate, targetDir, __dirname)
   console.log('    ✅ Axios 模板复制完成')
 }

package/lib/plugins/elementPlus.js

@@ -1,28 +1,28 @@
 // lib/plugins/elementPlus.js
-import { existsSync } from 'fs'
-import fs from 'fs/promises'
-import path from 'path'
+import { configurationMain } from "../utils"
 
+/**
+ * 配置 Element Plus
+ * @param {'ts' | 'js'} language - 项目语言
+ * @param {string} targetDir - 目标目录
+ * @param {string} __dirname - 当前模块目录路径
+ */
 export async function setupElementPlus (language, targetDir, __dirname) {
   console.log('  🎨 配置 Element Plus...')
 
   // 修改 main 文件
-  const mainFile = language === 'ts' ? 'main.ts' : 'main.js'
-  const mainPath = path.join(targetDir, `src/${mainFile}`)
-
-  if(!existsSync(mainPath)) {
-    throw new Error(`main 文件不存在: ${mainPath}`)
-  }
-
-  let content = await fs.readFile(mainPath, 'utf-8')
-  content = content.replace(
-    '/* __ELEMENT_IMPORT__ */',
-    `import ElementPlus from 'element-plus'\nimport zhCn from 'element-plus/es/locale/lang/zh-cn'\nimport 'element-plus/dist/index.css'\nimport * as ElementPlusIconsVue from '@element-plus/icons-vue'`
-  )
-  content = content.replace(
-    '/* __ELEMENT_USE__ */',
-    `app.use(ElementPlus, { locale: zhCn })\nfor (const [key, component] of Object.entries(ElementPlusIconsVue)) {\n  app.component(key, component)\n}`
-  )
-  await fs.writeFile(mainPath, content)
+  const elementPlusImport = `import ElementPlus from 'element-plus'\nimport zhCn from 'element-plus/es/locale/lang/zh-cn'\nimport 'element-plus/dist/index.css'\nimport * as ElementPlusIconsVue from '@element-plus/icons-vue'`
+  const elementPlusUse = `app.use(ElementPlus, { locale: zhCn })\nfor (const [key, component] of Object.entries(ElementPlusIconsVue)) {\n  app.component(key, component)\n}`
+  let array = [
+    {
+      template: '/* __ELEMENT_IMPORT__ */',
+      content: elementPlusImport
+    },
+    {
+      template: '/* __ELEMENT_USE__ */',
+      content: elementPlusUse
+    }
+  ]
+  configurationMain(language, targetDir, array)
   console.log('    ✅ main 文件已更新')
 }

package/lib/plugins/https.js

@@ -3,6 +3,10 @@ import { existsSync } from 'fs'
 import fs from 'fs/promises'
 import path from 'path'
 
+/**
+ * 配置 HTTPS（mkcert）
+ * @param {string} targetDir - 目标目录
+ */
 export async function setupHttps (targetDir) {
   console.log('  🔐 配置 HTTPS...')
 

package/lib/plugins/index.js

@@ -8,7 +8,13 @@ import { setupRouter } from './router.js'
 import { setupTailwind } from './tailwind.js'
 import { setupVant } from './vant.js'
 
-export async function setupPlugins (features, extraPlugins, context) {
+/**
+ * 配置所有选中的插件
+ * @param {PluginsConfig} plugins - 插件配置对象
+ * @param {PluginContext} context - 上下文对象
+ * @returns {Promise<UnusedPlaceholders>} 未使用的占位符集合
+ */
+export async function setupPlugins (plugins, context) {
   const { language, targetDir, autoRoute, enableHttps, __dirname } = context
 
   // 收集未使用的占位符
@@ -19,8 +25,8 @@ export async function setupPlugins (features, extraPlugins, context) {
 
   console.log('\n🔌 配置插件...')
 
-  // Router（先复制模板，再配置自动路由）
-  if(features.router) {
+  // Router
+  if(plugins.router) {
     await setupRouter(language, targetDir, __dirname)
     if(autoRoute) await setupAutoRoute(language, targetDir)
   } else {
@@ -29,7 +35,7 @@ export async function setupPlugins (features, extraPlugins, context) {
   }
 
   // Pinia
-  if(features.pinia) {
+  if(plugins.pinia) {
     await setupPinia(language, targetDir, __dirname)
   } else {
     unusedPlaceholders.import.push('/* __PINIA_IMPORT__ */')
@@ -37,7 +43,7 @@ export async function setupPlugins (features, extraPlugins, context) {
   }
 
   // Element Plus
-  if(features.ui.includes('element')) {
+  if(plugins.elementPlus) {
     await setupElementPlus(language, targetDir, __dirname)
   } else {
     unusedPlaceholders.import.push('/* __ELEMENT_IMPORT__ */')
@@ -45,7 +51,7 @@ export async function setupPlugins (features, extraPlugins, context) {
   }
 
   // Vant
-  if(features.ui.includes('vant')) {
+  if(plugins.vant) {
     await setupVant(language, targetDir, __dirname)
   } else {
     unusedPlaceholders.import.push('/* __VANT_IMPORT__ */')
@@ -53,17 +59,17 @@ export async function setupPlugins (features, extraPlugins, context) {
   }
 
   // Axios
-  if(features.axios) {
+  if(plugins.axios) {
     await setupAxios(language, targetDir, __dirname)
   }
 
   // Tailwind
-  if(extraPlugins.includes('tailwind')) {
+  if(plugins.tailwind) {
     await setupTailwind(language, targetDir, __dirname)
   }
 
   // HTTPS
-  if(enableHttps) {
+  if(plugins.https) {
     await setupHttps(targetDir)
   }
 

package/lib/plugins/pinia.js

@@ -1,36 +1,33 @@
 // lib/plugins/pinia.js
-import { existsSync } from 'fs'
-import fs from 'fs/promises'
-import path from 'path'
+import { configurationMain } from "../utils"
 
+/**
+ * 配置 Pinia
+ * @param {'ts' | 'js'} language - 项目语言
+ * @param {string} targetDir - 目标目录
+ * @param {string} __dirname - 当前模块目录路径
+ */
 export async function setupPinia (language, targetDir, __dirname) {
   console.log('  📦 配置 Pinia...')
 
   // 复制模板
   const piniaTemplate = language === 'ts' ? 'pinia-ts' : 'pinia-js'
-  const templatePath = path.resolve(__dirname, `../template/${piniaTemplate}`)
-
-  if(!existsSync(templatePath)) {
-    throw new Error(`模板不存在: ${templatePath}`)
-  }
-
-  await fs.cp(templatePath, targetDir, { recursive: true })
+  await copyTemplate(piniaTemplate, targetDir, __dirname)
   console.log('    ✅ Pinia 模板复制完成')
 
   // 修改 main 文件
-  const mainFile = language === 'ts' ? 'main.ts' : 'main.js'
-  const mainPath = path.join(targetDir, `src/${mainFile}`)
-
-  if(!existsSync(mainPath)) {
-    throw new Error(`main 文件不存在: ${mainPath}`)
-  }
-
-  let content = await fs.readFile(mainPath, 'utf-8')
-  content = content.replace(
-    '/* __PINIA_IMPORT__ */',
-    `import { createPinia } from 'pinia'\nimport persistedstate from 'pinia-plugin-persistedstate'`
-  )
-  content = content.replace('/* __PINIA_USE__ */', 'app.use(createPinia().use(persistedstate))')
-  await fs.writeFile(mainPath, content)
+  const piniaImport = `import { createPinia } from 'pinia'\nimport persistedstate from 'pinia-plugin-persistedstate'`
+  const piniaUse = 'app.use(createPinia().use(persistedstate))'
+  let array = [
+    {
+      template: '/* __PINIA_IMPORT__ */',
+      content: piniaImport
+    },
+    {
+      template: '/* __PINIA_USE__ */',
+      content: piniaUse
+    }
+  ]
+  configurationMain(language, targetDir, array)
   console.log('    ✅ main 文件已更新')
 }

package/lib/plugins/router.js

@@ -1,32 +1,33 @@
 // lib/plugins/router.js
-import { existsSync } from 'fs'
-import fs from 'fs/promises'
-import path from 'path'
+import { configurationMain, copyTemplate } from '../utils'
 
+/**
+ * 配置 Vue Router
+ * @param {'ts' | 'js'} language - 项目语言
+ * @param {string} targetDir - 目标目录
+ * @param {string} __dirname - 当前模块目录路径
+ */
 export async function setupRouter (language, targetDir, __dirname) {
   console.log('  🛤️ 配置 Router...')
 
   // 复制模板
   const routerTemplate = language === 'ts' ? 'router-ts' : 'router-js'
-  const templatePath = path.resolve(__dirname, `../template/${routerTemplate}`)
-  if(!existsSync(templatePath)) {
-    throw new Error(`模板不存在: ${templatePath}`)
-  }
-
-  await fs.cp(templatePath, targetDir, { recursive: true })
+  await copyTemplate(routerTemplate, targetDir, __dirname)
   console.log('    ✅ Router 模板复制完成')
 
   // 修改 main 文件
-  const mainFile = language === 'ts' ? 'main.ts' : 'main.js'
-  const mainPath = path.join(targetDir, `src/${mainFile}`)
-
-  if(!existsSync(mainPath)) {
-    throw new Error(`main 文件不存在: ${mainPath}`)
-  }
-
-  let content = await fs.readFile(mainPath, 'utf-8')
-  content = content.replace('/* __ROUTER_IMPORT__ */', "import router from './router'")
-  content = content.replace('/* __ROUTER_USE__ */', 'app.use(router)')
-  await fs.writeFile(mainPath, content)
+  const routerImport = "import router from './router'"
+  const routerUse = 'app.use(router)'
+  let array = [
+    {
+      template: '/* __ROUTER_IMPORT__ */',
+      content: routerImport
+    },
+    {
+      template: '/* __ROUTER_USE__ */',
+      content: routerUse
+    }
+  ]
+  configurationMain(language, targetDir, array)
   console.log('    ✅ main 文件已更新')
 }

package/lib/plugins/tailwind.js

@@ -2,19 +2,20 @@
 import { existsSync } from 'fs'
 import fs from 'fs/promises'
 import path from 'path'
+import { copyTemplate } from '../utils'
 
+/**
+ * 配置 Tailwind CSS
+ * @param {'ts' | 'js'} language - 项目语言
+ * @param {string} targetDir - 目标目录
+ * @param {string} __dirname - 当前模块目录路径
+ */
 export async function setupTailwind (language, targetDir, __dirname) {
   console.log('  🎨 配置 Tailwind CSS...')
 
   // 复制模板
   const tailwindTemplate = language === 'ts' ? 'tailwind-ts' : 'tailwind-js'
-  const templatePath = path.resolve(__dirname, `../template/${tailwindTemplate}`)
-
-  if(!existsSync(templatePath)) {
-    throw new Error(`模板不存在: ${templatePath}`)
-  }
-
-  await fs.cp(templatePath, targetDir, { recursive: true })
+  await copyTemplate(tailwindTemplate, targetDir, __dirname)
   console.log('    ✅ Tailwind 模板复制完成')
 
   // 更新 style.css

package/lib/plugins/vant.js

@@ -1,25 +1,29 @@
 // lib/plugins/vant.js
-import { existsSync } from 'fs'
-import fs from 'fs/promises'
-import path from 'path'
+import { configurationMain } from "../utils"
 
+
+/**
+ * 配置 Vant
+ * @param {'ts' | 'js'} language - 项目语言
+ * @param {string} targetDir - 目标目录
+ * @param {string} __dirname - 当前模块目录路径
+ */
 export async function setupVant (language, targetDir, __dirname) {
   console.log('  📱 配置 Vant...')
 
   // 修改 main 文件
-  const mainFile = language === 'ts' ? 'main.ts' : 'main.js'
-  const mainPath = path.join(targetDir, `src/${mainFile}`)
-
-  if(!existsSync(mainPath)) {
-    throw new Error(`main 文件不存在: ${mainPath}`)
-  }
-
-  let content = await fs.readFile(mainPath, 'utf-8')
-  content = content.replace(
-    '/* __VANT_IMPORT__ */',
-    `import Vant from 'vant'\nimport 'vant/lib/index.css'`
-  )
-  content = content.replace('/* __VANT_USE__ */', 'app.use(Vant)')
-  await fs.writeFile(mainPath, content)
+  const vantImport = `import Vant from 'vant'\nimport 'vant/lib/index.css'`
+  const vantUSE = 'app.use(Vant)'
+  let array = [
+    {
+      template: '/* __VANT_IMPORT__ */',
+      content: vantImport
+    },
+    {
+      template: '/* __VANT_USE__ */',
+      content: vantUSE
+    }
+  ]
+  configurationMain(language, targetDir, array)
   console.log('    ✅ main 文件已更新')
 }

package/lib/prompts.js

@@ -1,6 +1,14 @@
 // lib/prompts.js
 import prompts from 'prompts'
 
+/**
+ * 获取项目名称（交互式输入）
+ * @param {Object} fs - fs 模块
+ * @param {Function} fs.existsSync - 检查文件是否存在
+ * @param {Object} path - path 模块
+ * @param {Function} path.resolve - 解析路径
+ * @returns {Promise<string>} 项目名称
+ */
 export async function getProjectName (fs, path) {
   while(true) {
     const res = await prompts({
@@ -20,6 +28,10 @@ export async function getProjectName (fs, path) {
   }
 }
 
+/**
+ * 选择项目语言（交互式选择）
+ * @returns {Promise<'ts' | 'js'>} 选择的语言
+ */
 export async function chooseLanguage () {
   const { language } = await prompts({
     type: 'select',
@@ -33,6 +45,10 @@ export async function chooseLanguage () {
   return language
 }
 
+/**
+ * 选择功能特性（交互式多选）
+ * @returns {Promise<string[]>} 选择的功能列表
+ */
 export async function chooseFeatures () {
   const { featureList } = await prompts({
     type: 'multiselect',
@@ -56,6 +72,11 @@ export async function chooseFeatures () {
   return featureList || []
 }
 
+/**
+ * 询问是否开启自动路由
+ * @param {boolean} routerEnabled - 是否已启用 Router
+ * @returns {Promise<boolean>} 是否开启自动路由
+ */
 export async function askAutoRoute (routerEnabled) {
   if(!routerEnabled) return false
   const { enableAutoRoute } = await prompts({
@@ -69,6 +90,11 @@ export async function askAutoRoute (routerEnabled) {
   return enableAutoRoute
 }
 
+/**
+ * 询问是否立即运行开发服务器
+ * @param {string} devCommand - 开发服务器命令
+ * @returns {Promise<boolean>} 是否立即运行
+ */
 export async function askRunDev (devCommand) {
   const { runDev } = await prompts({
     type: 'select',

package/lib/template.js

@@ -2,17 +2,17 @@
 import { existsSync } from 'fs'
 import fs from 'fs/promises'
 import path from 'path'
-
+import { copyTemplate } from './utils'
+
+/**
+ * 复制基础模板到目标目录
+ * @param {'ts' | 'js'} language - 项目语言
+ * @param {string} targetDir - 目标目录
+ * @param {string} __dirname - 当前模块目录路径
+ */
 export async function copyBaseTemplate (language, targetDir, __dirname) {
   const baseTemplate = language === 'ts' ? 'base-ts' : 'base-js'
-  const templatePath = path.resolve(__dirname, '../template', baseTemplate)
-
-  if(!existsSync(templatePath)) {
-    throw new Error(`基础模板不存在: ${templatePath}`)
-  }
-
-  // 复制整个模板目录
-  await fs.cp(templatePath, targetDir, { recursive: true })
+  await copyTemplate(baseTemplate, targetDir, __dirname)
 
   // 重命名 main 文件（去掉 .tpl 后缀）
   const mainTplPath = path.join(targetDir, `src/main.${language === 'ts' ? 'ts' : 'js'}.tpl`)
@@ -33,6 +33,11 @@ export async function copyBaseTemplate (language, targetDir, __dirname) {
   console.log('  ✅ 基础模板复制完成')
 }
 
+/**
+ * 更新 index.html 中的标题
+ * @param {string} projectName - 项目名称
+ * @param {string} targetDir - 目标目录
+ */
 export async function updateIndexHtml (projectName, targetDir) {
   const indexPath = path.join(targetDir, 'index.html')
   if(!existsSync(indexPath)) return

package/lib/utils.js

@@ -1,7 +1,13 @@
 // lib/utils.js
 import { execSync } from 'child_process'
 import fs from 'fs'
+import fsPromise from 'fs/promises'
+import path from 'path'
 
+/**
+ * 检查 Node.js 版本是否符合要求
+ * @param {string} requiredVersion - 要求的版本号，如 "16.0.0"
+ */
 export function checkNodeVersion (requiredVersion) {
   const currentVersion = process.version.replace('v', '')
   if(compareVersion(currentVersion, requiredVersion) < 0) {
@@ -13,6 +19,12 @@ export function checkNodeVersion (requiredVersion) {
   }
 }
 
+/**
+ * 比较两个版本号
+ * @param {string} v1 - 版本号1
+ * @param {string} v2 - 版本号2
+ * @returns {-1 | 0 | 1} 1: v1 > v2, -1: v1 < v2, 0: 相等
+ */
 export function compareVersion (v1, v2) {
   const a = v1.split('.').map(Number)
   const b = v2.split('.').map(Number)
@@ -25,6 +37,10 @@ export function compareVersion (v1, v2) {
   return 0
 }
 
+/**
+ * 检测使用的包管理器
+ * @returns {PackageManager} 包管理器类型 ('npm' 或 'pnpm')
+ */
 export function detectPackageManager () {
   const userAgent = process.env.npm_config_user_agent || ''
   if(userAgent.startsWith('pnpm')) return 'pnpm'
@@ -33,6 +49,47 @@ export function detectPackageManager () {
   return 'npm'
 }
 
+/**
+ * 执行命令
+ * @param {string} cmd - 要执行的命令
+ * @param {string} [cwd=process.cwd()] - 工作目录
+ */
 export function runCmd (cmd, cwd = process.cwd()) {
   execSync(cmd, { cwd, stdio: 'inherit' })
+}
+
+/**
+ * 复制模板目录到目标位置
+ * @param {string} templateName - 模板名称
+ * @param {string} targetDir - 目标目录
+ * @param {string} __dirname - 当前模块目录路径
+ */
+export async function copyTemplate (templateName, targetDir, __dirname) {
+  const templatePath = path.resolve(__dirname, `../template/${templateName}`)
+  if(!existsSync(templatePath)) {
+    throw new Error(`模板不存在: ${templatePath}`)
+  }
+
+  await fsPromise.cp(templatePath, targetDir, { recursive: true })
+}
+
+/**
+ * 配置 main 文件（替换模板占位符）
+ * @param {'ts' | 'js'} language - 项目语言
+ * @param {string} targetDir - 目标目录
+ * @param {ConfigurationItem[]} configuration - 配置项数组
+ */
+export async function configurationMain (language, targetDir, configuration) {
+  const mainFile = language === 'ts' ? 'main.ts' : 'main.js'
+  const mainPath = path.join(targetDir, `src/${mainFile}`)
+
+  if(!existsSync(mainPath)) {
+    throw new Error(`main 文件不存在: ${mainPath}`)
+  }
+
+  let content = await fsPromise.readFile(mainPath, 'utf-8')
+  for(const item of configuration) {
+    content = content.replace(item.template, item.content)
+  }
+  await fsPromise.writeFile(mainPath, content)
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-vite-vue",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "基于Vite+Vue3创建基础项目模板",
   "main": "index.js",
   "author": "YwaiX",
@@ -22,6 +22,14 @@
     "pinia",
     "axios"
   ],
+  "files": [
+    "bin/",
+    "lib/",
+    "template/",
+    "types/",
+    "package.json",
+    "README.md"
+  ],
   "dependencies": {
     "prompts": "^2.4.2"
   }

package/types/global.d.ts

@@ -0,0 +1,72 @@
+// types/global.d.ts
+
+/**
+ * 插件配置对象
+ */
+interface PluginsConfig {
+  router: boolean
+  pinia: boolean
+  axios: boolean
+  elementPlus: boolean
+  vant: boolean
+  vueuse: boolean
+  lodash: boolean
+  dayjs: boolean
+  mitt: boolean
+  tailwind: boolean
+  https: boolean
+}
+
+/**
+ * 未使用的占位符集合
+ */
+interface UnusedPlaceholders {
+  import: string[]
+  use: string[]
+}
+
+/**
+ * 插件上下文对象
+ */
+interface PluginContext {
+  language: 'ts' | 'js'
+  targetDir: string
+  autoRoute: boolean
+  enableHttps: boolean
+  __dirname: string
+}
+
+/**
+ * main 文件配置项
+ */
+interface ConfigurationItem {
+  template: string
+  content: string
+}
+
+/**
+ * 包管理器类型
+ */
+type PackageManager = 'npm' | 'pnpm'
+
+/**
+ * 可选依赖版本映射
+ */
+interface OptionalDeps {
+  'vue-router'?: string
+  'pinia'?: string
+  'pinia-plugin-persistedstate'?: string
+  'axios'?: string
+  'element-plus'?: string
+  '@element-plus/icons-vue'?: string
+  'vant'?: string
+  '@vueuse/core'?: string
+  'dayjs'?: string
+  'lodash'?: string
+  'tailwindcss'?: string
+  '@tailwindcss/postcss'?: string
+  'postcss'?: string
+  'mitt'?: string
+  'vite-plugin-mkcert'?: string
+  'vite-plugin-pages'?: string
+}

package/.vscode/settings.json

@@ -1,22 +0,0 @@
-{
-  "workbench.colorCustomizations": {
-    "activityBar.activeBackground": "#65c89b",
-    "activityBar.background": "#65c89b",
-    "activityBar.foreground": "#15202b",
-    "activityBar.inactiveForeground": "#15202b99",
-    "activityBarBadge.background": "#945bc4",
-    "activityBarBadge.foreground": "#e7e7e7",
-    "commandCenter.border": "#15202b99",
-    "sash.hoverBorder": "#65c89b",
-    "statusBar.background": "#42b883",
-    "statusBar.foreground": "#15202b",
-    "statusBarItem.hoverBackground": "#359268",
-    "statusBarItem.remoteBackground": "#42b883",
-    "statusBarItem.remoteForeground": "#15202b",
-    "titleBar.activeBackground": "#42b883",
-    "titleBar.activeForeground": "#15202b",
-    "titleBar.inactiveBackground": "#42b88399",
-    "titleBar.inactiveForeground": "#15202b99"
-  },
-  "peacock.color": "#42b883"
-}