Vite React项目导入变量报错:plugin:vite:import-analysis解析失败
React+Vite项目导入变量报错的排查方案
先查路径是否正确
别小看路径问题,Vite有时候会把路径错误误报成语法错误。检查file2.js里的../utils/file1路径:
- 确认
file1.js确实在file2.js上级目录的utils文件夹里,比如file2.js在src/components,那file1.js得在src/utils才对。 - 可以给路径加上
.js后缀,写成../utils/file1.js,避免Vite解析路径时出现歧义。
排查Vite配置与项目模块类型
- 打开
vite.config.js,看看有没有错误配置了resolve或optimizeDeps规则,导致JS文件被错误识别成其他类型。 - 检查
package.json里的type字段:如果是"type": "module",你的ES模块导入导出语法是对的;如果是"commonjs",就得改成module.exports = { PAGE_SIZE: 10 }和const { PAGE_SIZE } = require("../utils/file1"),不过Vite默认支持ES模块,这个情况概率不高,但可以确认下。
检查文件是否有隐藏异常字符
有时候文件里会混入全角空格、不可见控制字符,导致Vite解析失败:
- 用编辑器的「显示所有字符」功能(比如VSCode按Ctrl+Shift+P搜「Toggle Render Whitespace」),看看代码里有没有奇怪的字符。
- 直接重新手动输入一遍两个文件的代码,覆盖原有内容,排除编码或隐藏字符问题。
清除Vite缓存试试
Vite的缓存偶尔会抽风,导致解析异常:
- 删除项目根目录下的
node_modules/.vite文件夹,然后重启npm run dev服务。
内容的提问来源于stack exchange,提问作者Alex
相关产品推荐
相关产品推荐

