feat(cli): add Node.js version warning for unsupported versions

packages/vite/src/node/__tests__/cli.spec.ts

@@ -0,0 +1,89 @@
+import { afterEach, beforeEach, describe, expect, test } from 'vitest'
+import { checkNodeVersion } from '../cli'
+
+describe('CLI Node.js version checking', () => {
+  let originalNodeVersion: string
+
+  beforeEach(() => {
+    originalNodeVersion = process.versions.node
+  })
+
+  afterEach(() => {
+    // Restore original version
+    Object.defineProperty(process.versions, 'node', {
+      value: originalNodeVersion,
+      writable: true,
+    })
+  })
+
+  function mockNodeVersion(version: string) {
+    Object.defineProperty(process.versions, 'node', {
+      value: version,
+      writable: true,
+    })
+  }
+
+  test('should return false for Node.js version < 20.19.0', () => {
+    mockNodeVersion('18.20.0')
+
+    const result = checkNodeVersion()
+
+    expect(result).toBe(false)
+  })
+
+  test('should return false for Node.js version 20.18.x', () => {
+    mockNodeVersion('20.18.5')
+
+    const result = checkNodeVersion()
+
+    expect(result).toBe(false)
+  })
+
+  test('should return false for Node.js version 22.11.x', () => {
+    mockNodeVersion('22.11.0')
+
+    const result = checkNodeVersion()
+
+    expect(result).toBe(false)
+  })
+
+  test('should return true for Node.js version 20.19.0', () => {
+    mockNodeVersion('20.19.0')
+
+    const result = checkNodeVersion()
+
+    expect(result).toBe(true)
+  })
+
+  test('should return true for Node.js version 20.20.x', () => {
+    mockNodeVersion('20.20.1')
+
+    const result = checkNodeVersion()
+
+    expect(result).toBe(true)
+  })
+
+  test('should return true for Node.js version 22.12.0', () => {
+    mockNodeVersion('22.12.0')
+
+    const result = checkNodeVersion()
+
+    expect(result).toBe(true)
+  })
+
+  test('should return true for Node.js version 22.13.x', () => {
+    mockNodeVersion('22.13.1')
+
+    const result = checkNodeVersion()
+
+    expect(result).toBe(true)
+  })
+
+  test('should return true for Node.js version 23.x.x', () => {
+    mockNodeVersion('23.0.0')
+
+    const result = checkNodeVersion()
+
+    expect(result).toBe(true)
+  })
+})

packages/vite/src/node/cli.ts

@@ -12,6 +12,36 @@ import { createLogger } from './logger'
 import { resolveConfig } from './config'
 import type { InlineConfig } from './config'
 
+/**
+ * Check if the current Node.js version is supported
+ * @returns true if the version is supported, false otherwise
+ */
+export function checkNodeVersion(): boolean {
+  const currentVersion = process.versions.node.split('.')
+  const major = parseInt(currentVersion[0], 10)
+  const minor = parseInt(currentVersion[1], 10)
+  const patch = parseInt(currentVersion[2], 10)
+
+  const isSupported =
+    (major === 20 && (minor > 19 || (minor === 19 && patch >= 0))) ||
+    (major === 22 && minor >= 12) ||
+    major > 22
+
+  return isSupported
+}
+
+// Check Node.js version before proceeding
+if (!checkNodeVersion()) {
+  // eslint-disable-next-line no-console
+  console.warn(
+    colors.yellow(
+      `You are using Node.js ${process.versions.node}. ` +
+        `Vite requires Node.js version 20.19+ or 22.12+. ` +
+        `Please upgrade your Node.js version.`,
+    ),
+  )
+}
+
 const cli = cac('vite')
 
 // global options