本文详解在WSL等环境中因Node.js版本过低（如v10.19.0）导致create-vite@latest执行失败的问题，核心原因在于旧版Node不支持ESM import语法；提供升级Node、降级Vite、验证环境三步实操方案，并附权威版本兼容性对照与避坑建议。
本文详解在wsl等环境中因node.js版本过低（如v10.19.0）导致`create-vite@latest`执行失败的问题，核心原因在于旧版node不支持esm `import`语法；提供升级node、降级vite、验证环境三步实操方案，并附权威版本兼容性对照与避坑建议。
当你在WSL中运行 npx create-vite@latest client 却遭遇如下错误：
SyntaxError: Unexpected string
at Module._compile (internal/modules/cjs/loader.js:723:23)
import './dist/index.mjs'
^^^^^^^^^^^^^^^^^^这并非网络或权限问题，而是Node.js运行时根本无法解析ES模块语法（import/export）——因为你的当前版本为 Node.js v10.19.0（发布于2018年），而create-vite自v3.0起已全面采用ESM构建，要求最低Node版本为 v14.18.0+（ESM稳定支持起点），官方推荐环境更是明确要求 Node.js ≥ v20.19.0 或 ≥ v22.12.0（见Vite 5.x+及create-vite 9.x+文档）。
✅ 正确解决路径：三步闭环处理
1️⃣ 【首选】升级Node.js至LTS或Current版本（强烈推荐）
- 访问 https://www.php.cn/link/5b18e1a3e2092783aea4b1aa4a894d8a 下载最新LTS版本（截至2026年8月为 v20.19.0 或 v22.14.0）；
- 在WSL中推荐使用
nvm（Node Version Manager） 安全切换版本（避免污染系统环境）：
# 安装nvm（适用于WSL Ubuntu/Debian） curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc # 或 ~/.zshrc # 查看可用LTS版本并安装 nvm list-remote --lts nvm install --lts # 自动安装最新LTS（如v20.19.0） # 验证 node -v # 应输出 v20.19.0+ npm -v # 建议同步升级至 npm ≥ 10.7.0
⚠️ 注意：切勿使用
sudo npm install -g n等全局升级方式——易引发权限冲突与EBADENGINE警告。
2️⃣ 【临时兼容】降级create-vite以适配旧Node（仅限调试）
若受制于系统策略暂无法升级Node，可指定兼容旧版的create-vite历史版本（需Node ≥ v12.20.0）：
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
# 使用create-vite v4.5.3（最后支持Node v12+的稳定版） npx create-vite@4.5.3 client --template vue # 或强制指定Node引擎忽略（不推荐生产使用） NODE_OPTIONS=--no-warnings npx --ignore-engines create-vite@4.5.3 client
? 验证兼容性：
create-vite@4.x要求 Node ≥^12.20.0 || ^14.18.0 || >=16.0.0；@5.x+已弃用Node v12/v14支持。
3️⃣ 【必做】清理缓存并重试（避免残留干扰）
旧版npm缓存可能保留损坏的create-vite二进制，务必清除：
npm cache clean --force rm -rf ~/.npm/_npx/ # 清理npx临时模块 npx clear-npx-cache # （如已安装） # 再次创建（确保无警告） npx create-vite@latest client --template vue-ts
? 关键注意事项与最佳实践
-
永远检查引擎约束：执行
npx命令前，先运行npm view create-vite engines查看其node字段要求； -
WSL专属提醒：确保
/etc/wsl.conf中启用[automount] enabled = true，避免Windows路径映射导致模块解析失败； -
拒绝“打补丁式”修复：不要尝试添加
--experimental-modules或修改type: "module"——create-vite本身是编译后产物，非源码项目，该参数对.mjs入口无效； -
长期维护建议：使用
nvm管理多版本Node，在团队项目根目录添加.nvmrc文件（如内容为20.19.0），配合CI脚本自动校验，从源头规避兼容性风险。
✅ 最终验证成功标志：
控制台输出Scaffolding project in ./client→Installing dependencies with npm→Starting dev server > vite并打开http://localhost:5173正常渲染欢迎页。
现代前端工具链（Vite、Vitest、Rolldown）已深度绑定ESM与新版V8特性。与其绕过语法限制，不如将本次报错视为一次必要的环境升级契机——它不仅解决当前问题，更保障你后续无缝接入Vue 3.5、TypeScript 5.5、以及所有基于ESM生态的新一代开发体验。
