@dengzhibo/create-vue-template 0.0.1 → 0.0.3

package/CHANGELOG.md

@@ -1,7 +1,15 @@
-# 更新日志
-
-## v0 系列
-
-### v0.0.1 (2026-10-22) 
-
-* vue 脚手架创建项目
+# 更新日志
+
+## v0 系列
+
+### v0.0.1 (2026-10-22) 
+
+* vue 脚手架创建项目
+
+### v0.0.2 (2026-10-22) 
+
+* 修复文本相同但文件不匹配问题
+
+### v0.0.3 (2026-10-22) 
+
+* 新增JSX功能，优化代码

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) [2026] [DengZhiBo]
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) [2026] [DengZhiBo]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,63 +1,63 @@
-# Vue + Vite 模板脚手架
-
-生成现有 Vue + Vite + TypeScript 应用，保留 Router、Pinia 和 Vue DevTools。
-
-## 用户使用（发布到 npm 后）
-
-```sh
-pnpm create @dengzhibo/vue-template@latest my-vue-app
-
-# 等价的完整包名调用
-pnpm dlx @dengzhibo/create-vue-template@latest my-vue-app
-
-# 全选并安装依赖
-pnpm create @dengzhibo/vue-template@latest my-vue-app --yes "--features=code-quality,unit-test,e2e" --install
-
-# 不选任何功能，不安装依赖
-pnpm create @dengzhibo/vue-template@latest my-vue-app --yes --features=
-```
-
-以上命令会从 npm 获取并运行脚手架，无需下载源码或全局安装；必须先发布对应包。`--install` 控制的是生成项目的依赖安装，不是脚手架自身的下载。每个示例独立执行，请使用空目录。
-
-命令说明：[pnpm create](https://pnpm.io/cli/create)、[pnpm dlx](https://pnpm.io/cli/dlx)。
-
-项目名取目标目录名，支持 my-vue-app 等带连字符名称；目录参数可使用相对路径、绝对路径或当前目录 .。目标目录必须为空，允许保留 .git。
-
-向导顺序：创建位置 → 功能多选 → 是否安装依赖 → 确认、返回修改或取消。
-
-功能默认全部不选，Space 勾选，Enter 确认，可任意组合：
-
-- 代码规范（code-quality）：ESLint + Oxlint + Oxfmt。
-- 单元测试（unit-test）：Vitest、Vue Test Utils 和现有测试示例。
-- 端到端测试（e2e）：Playwright 和现有测试示例。
-
-Windows PowerShell 中，包含逗号的 `--features` 参数应加引号，如上例。
-
---yes 使用非交互模式；--features= 指定逗号分隔的功能，空值为全部不选；--install 执行 pnpm install，默认不安装。
-
-未选择的功能不生成对应配置、依赖、脚本或编辑器推荐。测试的 ESLint 规则仅在代码规范与相应测试同时选择时生成。
-
-不生成 Git hooks、CI、Docker 或部署管理。基础模板现有 Vue RC 与 TypeScript bridge 覆盖保持原样；本次仅拆分现有能力。
-
-CLI Node 要求见 package.json；生成应用的 Node 要求见 templates/base/package.json。
-
-## 源码开发与维护
-
-仅在本包源码目录中使用以下命令进行本地调试：
-
-```sh
-node bin/index.js my-vue-app
-```
-
-验证：
-
-```sh
-node --test tests/*.test.mjs
-node scripts/check-package.mjs
-```
-
-测试覆盖 8 种功能组合、CLI 参数、向导返回修改、取消及目标目录保护。不要在 templates 内安装依赖。
-
-## 发布文件范围
-
-`bin/`、`lib/`、`templates/`、README、CHANGELOG、LICENSE 与 package.json 随 npm 包发布。测试、预检脚本、AGENTS.md 和本地缓存仅用于仓库维护，不需要上传 npm。`_gitignore` 在生成项目时恢复为 `.gitignore`。
+# Vue + Vite 模板脚手架
+
+生成现有 Vue + Vite + TypeScript 应用，保留 Router、Pinia 和 Vue DevTools。
+
+## 用户使用（发布到 npm 后）
+
+```sh
+pnpm create @dengzhibo/vue-template@latest my-vue-app
+
+# 等价的完整包名调用
+pnpm dlx @dengzhibo/create-vue-template@latest my-vue-app
+
+# 全选并安装依赖
+pnpm create @dengzhibo/vue-template@latest my-vue-app --yes "--features=code-quality,unit-test,e2e" --install
+
+# 不选任何功能，不安装依赖
+pnpm create @dengzhibo/vue-template@latest my-vue-app --yes --features=
+```
+
+以上命令会从 npm 获取并运行脚手架，无需下载源码或全局安装；必须先发布对应包。`--install` 控制的是生成项目的依赖安装，不是脚手架自身的下载。每个示例独立执行，请使用空目录。
+
+命令说明：[pnpm create](https://pnpm.io/cli/create)、[pnpm dlx](https://pnpm.io/cli/dlx)。
+
+项目名取目标目录名，支持 my-vue-app 等带连字符名称；目录参数可使用相对路径、绝对路径或当前目录 .。目标目录必须为空，允许保留 .git。
+
+向导顺序：创建位置 → 功能多选 → 是否安装依赖 → 确认、返回修改或取消。
+
+功能默认全部不选，Space 勾选，Enter 确认，可任意组合：
+
+- 代码规范（code-quality）：ESLint + Oxlint + Oxfmt。
+- 单元测试（unit-test）：Vitest、Vue Test Utils 和现有测试示例。
+- 端到端测试（e2e）：Playwright 和现有测试示例。
+
+Windows PowerShell 中，包含逗号的 `--features` 参数应加引号，如上例。
+
+--yes 使用非交互模式；--features= 指定逗号分隔的功能，空值为全部不选；--install 执行 pnpm install，默认不安装。
+
+未选择的功能不生成对应配置、依赖、脚本或编辑器推荐。测试的 ESLint 规则仅在代码规范与相应测试同时选择时生成。
+
+不生成 Git hooks、CI、Docker 或部署管理。基础模板现有 Vue RC 与 TypeScript bridge 覆盖保持原样；本次仅拆分现有能力。
+
+CLI Node 要求见 package.json；生成应用的 Node 要求见 templates/base/package.json。
+
+## 源码开发与维护
+
+仅在本包源码目录中使用以下命令进行本地调试：
+
+```sh
+node bin/index.js my-vue-app
+```
+
+验证：
+
+```sh
+node --test tests/*.test.mjs
+node scripts/check-package.mjs
+```
+
+测试覆盖 8 种功能组合、CLI 参数、向导返回修改、取消及目标目录保护。不要在 templates 内安装依赖。
+
+## 发布文件范围
+
+`bin/`、`lib/`、`templates/`、README、CHANGELOG、LICENSE 与 package.json 随 npm 包发布。测试、预检脚本、AGENTS.md 和本地缓存仅用于仓库维护，不需要上传 npm。`_gitignore` 在生成项目时恢复为 `.gitignore`。

package/bin/index.js

@@ -1,39 +1,39 @@
-#!/usr/bin/env node
-/* eslint-disable no-console */
-import { execSync } from 'node:child_process'
-import { createPlan, writePlan } from '../lib/generate.js'
-import { help, parseArgs } from '../lib/options.js'
-import { Cancelled, collectOptions } from '../lib/prompts.js'
-
-async function main() {
-  const args = process.argv.slice(2)
-  const parsed = parseArgs(args)
-  if (parsed.help) {
-    console.log(help)
-    return
-  }
-  if (!parsed.yes && (!process.stdin.isTTY || !process.stdout.isTTY))
-    throw new Error('非交互环境请使用 --yes')
-  const options = parsed.yes ? parsed.options : await collectOptions(parsed.options)
-  if (!options) {
-    console.log('已取消，未创建项目。')
-    return
-  }
-  const target = writePlan(createPlan(options))
-  console.log(`✔ 项目已创建：${target}`)
-  if (options.install) {
-    try {
-      execSync('pnpm install', { cwd: target, stdio: 'inherit' })
-    }
-    catch {
-      console.error('安装失败，文件保留，请手动运行 pnpm install')
-      process.exitCode = 1
-      return
-    }
-  }
-  console.log(`cd "${target}"\n${options.install ? '' : 'pnpm install\n'}pnpm dev`)
-}
-main().catch((error) => {
-  console.error(error instanceof Cancelled ? '已取消，未创建项目。' : error.message)
-  process.exitCode = error instanceof Cancelled ? 130 : 1
-})
+#!/usr/bin/env node
+/* eslint-disable no-console */
+import { execSync } from 'node:child_process'
+import { createPlan, writePlan } from '../lib/generate.js'
+import { help, parseArgs } from '../lib/options.js'
+import { Cancelled, collectOptions } from '../lib/prompts.js'
+
+async function main() {
+  const args = process.argv.slice(2)
+  const parsed = parseArgs(args)
+  if (parsed.help) {
+    console.log(help)
+    return
+  }
+  if (!parsed.yes && (!process.stdin.isTTY || !process.stdout.isTTY))
+    throw new Error('非交互环境请使用 --yes')
+  const options = parsed.yes ? parsed.options : await collectOptions(parsed.options)
+  if (!options) {
+    console.log('已取消，未创建项目。')
+    return
+  }
+  const target = writePlan(createPlan(options))
+  console.log(`✔ 项目已创建：${target}`)
+  if (options.install) {
+    try {
+      execSync('pnpm install', { cwd: target, stdio: 'inherit' })
+    }
+    catch {
+      console.error('安装失败，文件保留，请手动运行 pnpm install')
+      process.exitCode = 1
+      return
+    }
+  }
+  console.log(`cd "${target}"\n${options.install ? '' : 'pnpm install\n'}pnpm dev`)
+}
+main().catch((error) => {
+  console.error(error instanceof Cancelled ? '已取消，未创建项目。' : error.message)
+  process.exitCode = error instanceof Cancelled ? 130 : 1
+})

package/lib/generate.js

@@ -1,100 +1,110 @@
-import fs from 'node:fs'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { assertTarget, featureLabels, normalizeOptions } from './options.js'
-
-const templateDir = fileURLToPath(new URL('../templates/', import.meta.url))
-const skip = new Set(['node_modules', 'dist', '.npmignore', '.git', '.DS_Store', 'pnpm-lock.yaml', '.turbo'])
-const rename = { _gitignore: '.gitignore' }
-const encode = value => `${JSON.stringify(value, null, 2)}\n`
-export function createPlan(input = {}, cwd = process.cwd()) {
-  const options = normalizeOptions(input)
-  const target = path.resolve(cwd, options.location)
-  const name = path.basename(target)
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { assertTarget, featureLabels, normalizeOptions } from './options.js'
+
+const templateDir = fileURLToPath(new URL('../templates/', import.meta.url))
+const skip = new Set(['node_modules', 'dist', '.npmignore', '.git', '.DS_Store', 'pnpm-lock.yaml', '.turbo'])
+const rename = { _gitignore: '.gitignore' }
+const encode = value => `${JSON.stringify(value, null, 2)}\n`
+export function createPlan(input = {}, cwd = process.cwd()) {
+  const options = normalizeOptions(input)
+  const target = path.resolve(cwd, options.location)
+  const name = path.basename(target)
   if (!/^[a-z0-9][\w.-]*$/i.test(name))
-    throw new Error('项目名不合法')
-  assertTarget(target)
-  const files = new Map()
-  const has = feature => options.features.includes(feature)
-  function add(directory, relative = '') {
-    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+    throw new Error('项目名不合法')
+  assertTarget(target)
+  const files = new Map()
+  const has = feature => options.features.includes(feature)
+  function add(directory, relative = '') {
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
       if (skip.has(entry.name) || entry.name.endsWith('.fragment.json'))
-        continue
-      const source = path.join(directory, entry.name)
+        continue
+      const source = path.join(directory, entry.name)
       if (entry.isSymbolicLink())
-        throw new Error(`模板不支持符号链接：${source}`)
-      const destination = path.posix.join(relative, rename[entry.name] || entry.name)
+        throw new Error(`模板不支持符号链接：${source}`)
+      const destination = path.posix.join(relative, rename[entry.name] || entry.name)
       if (entry.isDirectory()) {
         add(source, destination)
-      }
-      else {
+      }
+      else {
         if (files.has(destination))
-          throw new Error(`模板文件冲突：${destination}`)
-        files.set(destination, fs.readFileSync(source))
-      }
-    }
-  }
-  add(path.join(templateDir, 'base'))
-  const parse = file => JSON.parse(files.get(file).toString())
-  const pkg = parse('package.json')
-  for (const feature of options.features) {
-    const directory = path.join(templateDir, 'features', feature)
-    add(directory)
-    const fragment = JSON.parse(fs.readFileSync(path.join(directory, 'package.fragment.json'), 'utf8'))
-    for (const field of ['scripts', 'dependencies', 'devDependencies']) {
-      for (const [key, value] of Object.entries(fragment[field] || {})) {
-        pkg[field] ||= {}
+          throw new Error(`模板文件冲突：${destination}`)
+        files.set(destination, fs.readFileSync(source))
+      }
+    }
+  }
+  add(path.join(templateDir, 'base'))
+  const parse = file => JSON.parse(files.get(file).toString())
+  const pkg = parse('package.json')
+  for (const feature of options.features) {
+    const directory = path.join(templateDir, 'features', ({ 'unit-test': 'Vitest', 'jsx': 'JSX' })[feature] || feature)
+    add(directory)
+    const fragment = JSON.parse(fs.readFileSync(path.join(directory, 'package.fragment.json'), 'utf8'))
+    for (const field of ['scripts', 'dependencies', 'devDependencies']) {
+      for (const [key, value] of Object.entries(fragment[field] || {})) {
+        pkg[field] ||= {}
         if (Object.hasOwn(pkg[field], key) && pkg[field][key] !== value)
-          throw new Error(`配置冲突：${key}`)
-        pkg[field][key] = value
-      }
-    }
-  }
-  const extensions = parse('.vscode/extensions.json')
-  if (has('unit-test')) {
-    const tsconfig = parse('tsconfig.json')
-    tsconfig.references.push({ path: './tsconfig.vitest.json' })
-    files.set('tsconfig.json', encode(tsconfig))
-    extensions.recommendations.push('vitest.explorer')
-  }
+          throw new Error(`配置冲突：${key}`)
+        pkg[field][key] = value
+      }
+    }
+  }
+  if (has('jsx')) {
+    const vite = files.get('vite.config.ts').toString().replace(/\r\n/g, '\n').replace('import vue from \'@vitejs/plugin-vue\'', 'import vue from \'@vitejs/plugin-vue\'\nimport vueJsx from \'@vitejs/plugin-vue-jsx\'').replace('    vue(),', '    vue(),\n    vueJsx(),')
+    files.set('vite.config.ts', vite)
+    const tsconfig = files.get('tsconfig.app.json').toString().replace('"compilerOptions": {', '"compilerOptions": {\n    "jsx": "preserve",\n    "jsxImportSource": "vue",')
+    files.set('tsconfig.app.json', tsconfig)
+  }
+  const extensions = parse('.vscode/extensions.json')
+  if (has('unit-test')) {
+    const tsconfig = parse('tsconfig.json')
+    tsconfig.references.push({ path: './tsconfig.vitest.json' })
+    files.set('tsconfig.json', encode(tsconfig))
+    extensions.recommendations.push('vitest.explorer')
+  }
   if (has('e2e'))
-    extensions.recommendations.push('ms-playwright.playwright')
-  if (has('code-quality')) {
-    let eslint = files.get('eslint.config.ts').toString().replace(/\r\n/g, '\n')
-    for (const [feature, plugin, dependency] of [['unit-test', 'pluginVitest', '@vitest/eslint-plugin'], ['e2e', 'pluginPlaywright', 'eslint-plugin-playwright']]) {
-      if (!has(feature)) {
-        delete pkg.devDependencies[dependency]
-        eslint = eslint.replace(new RegExp(`^import ${plugin}.*\\n`, 'm'), '')
-        eslint = eslint.replace(new RegExp(`  \{\\n    \\.\\.\\.${plugin}[\\s\\S]*?\\n  \},\\n`), '')
-      }
-    }
-    files.set('eslint.config.ts', eslint)
-    const oxlint = parse('.oxlintrc.json')
+    extensions.recommendations.push('ms-playwright.playwright')
+  if (has('code-quality')) {
+    let eslint = files.get('eslint.config.ts').toString().replace(/\r\n/g, '\n')
+    for (const [feature, plugin, dependency] of [['unit-test', 'pluginVitest', '@vitest/eslint-plugin'], ['e2e', 'pluginPlaywright', 'eslint-plugin-playwright']]) {
+      if (!has(feature)) {
+        delete pkg.devDependencies[dependency]
+        eslint = eslint.replace(new RegExp(`^import ${plugin}.*\\n`, 'm'), '')
+        eslint = eslint.replace(new RegExp(`  \{\\n    \\.\\.\\.${plugin}[\\s\\S]*?\\n  \},\\n`), '')
+      }
+    }
+    files.set('eslint.config.ts', eslint)
+    const oxlint = parse('.oxlintrc.json')
     if (!has('unit-test'))
-      oxlint.plugins = oxlint.plugins.filter(p => p !== 'vitest')
-    files.set('.oxlintrc.json', encode(oxlint))
-    const settings = JSON.parse(fs.readFileSync(path.join(templateDir, 'features/code-quality/settings.fragment.json'), 'utf8'))
-    files.set('.vscode/settings.json', encode({ ...parse('.vscode/settings.json'), ...settings }))
-    extensions.recommendations.push('dbaeumer.vscode-eslint', 'EditorConfig.EditorConfig', 'oxc.oxc-vscode')
-  }
-  files.set('.vscode/extensions.json', encode(extensions))
-  pkg.name = name
-  files.set('package.json', encode(pkg))
-  let readme = files.get('README.md').toString().replace(/\r\n/g, '\n')
-  const sections = [['unit-test', 'Run Unit Tests'], ['e2e', 'Run End-to-End Tests'], ['code-quality', 'Lint with']]
-  for (const [feature, title] of sections) {
+      oxlint.plugins = oxlint.plugins.filter(p => p !== 'vitest')
+    files.set('.oxlintrc.json', encode(oxlint))
+    const settings = JSON.parse(fs.readFileSync(path.join(templateDir, 'features/code-quality/settings.fragment.json'), 'utf8'))
+    files.set('.vscode/settings.json', encode({ ...parse('.vscode/settings.json'), ...settings }))
+    extensions.recommendations.push('dbaeumer.vscode-eslint', 'EditorConfig.EditorConfig', 'oxc.oxc-vscode')
+  }
+  files.set('.vscode/extensions.json', encode(extensions))
+  pkg.name = name
+  const scriptOrder = ['dev', 'build', 'preview', 'test:unit', 'test:e2e', 'build-only', 'type-check', 'lint', 'lint:oxlint', 'lint:eslint', 'format']
+  pkg.scripts = Object.fromEntries(scriptOrder.filter(key => Object.hasOwn(pkg.scripts, key)).map(key => [key, pkg.scripts[key]]))
+  for (const field of ['dependencies', 'devDependencies'])
+    pkg[field] = Object.fromEntries(Object.entries(pkg[field]).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0))
+  files.set('package.json', encode(pkg))
+  let readme = files.get('README.md').toString().replace(/\r\n/g, '\n')
+  const sections = [['unit-test', 'Run Unit Tests'], ['e2e', 'Run End-to-End Tests'], ['code-quality', 'Lint with']]
+  for (const [feature, title] of sections) {
     if (!has(feature))
-      readme = readme.replace(new RegExp(`### ${title}[\\s\\S]*?(?=\\n### |$)`), '')
-  }
-  files.set('README.md', `${readme.replace('# base', `# ${name}`).trimEnd()}\n\n已选功能：${options.features.map(f => featureLabels[f]).join('、') || '无'}\n`)
-  return { target, options, files }
-}
-export function writePlan(plan) {
-  assertTarget(plan.target)
-  for (const [relative, content] of plan.files) {
-    const file = path.join(plan.target, relative)
-    fs.mkdirSync(path.dirname(file), { recursive: true })
-    fs.writeFileSync(file, content)
-  }
-  return plan.target
-}
+      readme = readme.replace(new RegExp(`### ${title}[\\s\\S]*?(?=\\n### |$)`), '')
+  }
+  files.set('README.md', `${readme.replace('# base', `# ${name}`).trimEnd()}\n\n已选功能：${options.features.map(f => featureLabels[f]).join('、') || '无'}\n`)
+  return { target, options, files }
+}
+export function writePlan(plan) {
+  assertTarget(plan.target)
+  for (const [relative, content] of plan.files) {
+    const file = path.join(plan.target, relative)
+    fs.mkdirSync(path.dirname(file), { recursive: true })
+    fs.writeFileSync(file, content)
+  }
+  return plan.target
+}

package/lib/options.js

@@ -1,53 +1,53 @@
-import fs from 'node:fs'
-import path from 'node:path'
-
-export const featureLabels = { 'code-quality': '代码规范', 'unit-test': '单元测试', 'e2e': '端到端测试' }
-export function normalizeOptions(input = {}) {
-  const features = input.features ?? []
-  if (!Array.isArray(features) || features.some(f => !Object.hasOwn(featureLabels, f)))
-    throw new Error('功能仅支持 code-quality、unit-test、e2e')
-  return { location: input.location || '.', features: Object.keys(featureLabels).filter(f => features.includes(f)), install: Boolean(input.install) }
-}
-export function assertTarget(target) {
-  let current = target
-  while (true) {
-    if (fs.existsSync(current) && fs.lstatSync(current).isSymbolicLink())
-      throw new Error('目标路径不能经过符号链接')
-    const parent = path.dirname(current)
-    if (parent === current)
-      break
-    current = parent
-  }
-  if (fs.existsSync(target) && (!fs.statSync(target).isDirectory() || fs.readdirSync(target).some(name => name !== '.git')))
-    throw new Error('目标必须为空目录（允许保留 .git）')
-}
-
-export const help = `用法：create-vue-template [目录] [选项]
-  --yes, -y           非交互创建
-  --features=code-quality,unit-test,e2e  选择功能，默认全部不选
-  --features=         全部不选
-  --install           安装依赖，默认不安装
-  --help, -h          帮助
-项目名取目标目录名，例如 my-vue-app。`
-export function parseArgs(args) {
-  if (args.includes('--help') || args.includes('-h'))
-    return { help: true }
-  const options = normalizeOptions()
-  const locations = []
-  let yes = false
-  for (const arg of args) {
+import fs from 'node:fs'
+import path from 'node:path'
+
+export const featureLabels = { 'code-quality': '代码规范', 'unit-test': '单元测试', 'e2e': '端到端测试', 'jsx': 'JSX 支持' }
+export function normalizeOptions(input = {}) {
+  const features = input.features ?? []
+  if (!Array.isArray(features) || features.some(f => !Object.hasOwn(featureLabels, f)))
+    throw new Error('功能仅支持 code-quality、unit-test、e2e、jsx')
+  return { location: input.location || '.', features: Object.keys(featureLabels).filter(f => features.includes(f)), install: Boolean(input.install) }
+}
+export function assertTarget(target) {
+  let current = target
+  while (true) {
+    if (fs.existsSync(current) && fs.lstatSync(current).isSymbolicLink())
+      throw new Error('目标路径不能经过符号链接')
+    const parent = path.dirname(current)
+    if (parent === current)
+      break
+    current = parent
+  }
+  if (fs.existsSync(target) && (!fs.statSync(target).isDirectory() || fs.readdirSync(target).some(name => name !== '.git')))
+    throw new Error('目标必须为空目录（允许保留 .git）')
+}
+
+export const help = `用法：create-vue-template [目录] [选项]
+  --yes, -y           非交互创建
+  --features=code-quality,unit-test,e2e,jsx  选择功能，默认全部不选
+  --features=         全部不选
+  --install           安装依赖，默认不安装
+  --help, -h          帮助
+项目名取目标目录名，例如 my-vue-app。`
+export function parseArgs(args) {
+  if (args.includes('--help') || args.includes('-h'))
+    return { help: true }
+  const options = normalizeOptions()
+  const locations = []
+  let yes = false
+  for (const arg of args) {
     if (['--yes', '-y'].includes(arg))
-      yes = true
+      yes = true
     else if (arg.startsWith('--features='))
-      options.features = arg.slice('--features='.length) === '' ? [] : arg.slice('--features='.length).split(',')
+      options.features = arg.slice('--features='.length) === '' ? [] : arg.slice('--features='.length).split(',')
     else if (arg === '--install')
-      options.install = true
+      options.install = true
     else if (arg.startsWith('-'))
-      throw new Error(`未知参数：${arg}`)
-    else locations.push(arg)
-  }
+      throw new Error(`未知参数：${arg}`)
+    else locations.push(arg)
+  }
   if (locations.length > 1)
-    throw new Error('只能指定一个创建目录')
-  options.location = locations[0] || '.'
-  return { options: normalizeOptions(options), yes }
-}
+    throw new Error('只能指定一个创建目录')
+  options.location = locations[0] || '.'
+  return { options: normalizeOptions(options), yes }
+}