WebStorm打开Vue+Vite项目后npm run dev启动失败求助

问题场景 #

近期安装WebStorm后打开Vue+Vite项目，原本在Visual Studio和命令行中正常运行的npm run dev命令报错，提示build.js中的import语句被当作非模块处理：

> clientapp@0.0.0 dev
> vite

failed to load config from {Project}\_Client\vite.config.js
error when starting dev server:
{Project}\build.js:1
import { fileURLToPath, URL } from 'url'
^^^^^^

SyntaxError: Cannot use import statement outside a module
...

向package.json添加"type": "module"后编译通过，但运行时出现ReferenceError: module is not defined in ES module scope错误。尝试过将JS配置文件改为TS、从Git重新拉取项目、重启系统等方法无效，最终将vite.config.js改为vite.config.mjs、build.js改为build.mjs后服务恢复。

核心疑问 #

除了package.json中的"type": "module"字段外，还有哪些设置会影响JS文件是否被默认识别为ES模块？

影响JS模块识别的其他因素 #

• Node.js版本差异：不同Node.js版本对ES模块的支持程度不同，若WebStorm使用的Node版本与之前Visual Studio/命令行的版本不一致（比如WebStorm配置了独立的Node环境），可能导致模块解析规则变化。可通过在WebStorm终端和系统终端分别执行node -v对比版本。
• WebStorm的Node运行参数：在WebStorm的「Run/Debug Configurations」中，针对npm run dev的配置可能添加了影响模块加载的参数，比如--input-type=commonjs会强制将JS文件当作CommonJS模块处理，或者--experimental-modules等实验性参数改变了模块解析逻辑。
• WebStorm的JavaScript语言配置：在Settings > Languages & Frameworks > JavaScript中，若JavaScript Language Version设置过低（比如低于ES6），或文件类型关联错误（将.js文件关联到非ES模块类型），可能影响WebStorm对文件的识别，间接导致Node加载时的模块类型判断异常。
• Node.js的后缀优先级规则：Node.js本身对文件后缀有明确的模块类型约定：.mjs默认是ES模块，.cjs默认是CommonJS，优先级高于package.json的type字段。这也是改后缀能直接解决问题的原因——绕过了package.json的全局模块类型设置。
• 项目中的.node-version/.nvmrc文件：如果项目根目录存在这些版本控制文件，WebStorm可能自动切换到指定的Node版本，若该版本对ES模块的处理与之前使用的版本不同，就会出现识别异常。
• Vite配置的特殊处理：Vite对配置文件的加载有自己的逻辑，比如会优先识别.mjs/.ts后缀的配置文件，若vite.config.js的加载逻辑受插件或Vite版本影响，也可能导致模块识别异常（不过这更多是Vite层面的处理，而非Node本身的模块规则）。

补充说明 #

WebStorm打开项目后自动执行npm i可能导致依赖版本变化，部分Vite或相关依赖的更新可能改变了模块解析的默认行为，这也可能是问题触发的诱因之一。

内容的提问来源于stack exchange，提问作者greg-e