VSCode智能提示与自动补全问题：Vite、jsconfig及别名配置冲突排查

问题根源 #

你的jsconfig.json缺少模块解析相关的关键配置，导致VSCode在识别项目别名时，无法兼容node_modules的模块解析逻辑，进而出现二选一的冲突。

解决方案 #

保留Vite配置中的别名（项目运行依赖，不能删除），同时修改jsconfig.json补充必要的编译器选项，让VSCode同时兼容别名和node_modules的智能提示：

{
  "compilerOptions": {
    "target": "ESNext",
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"],
      "img/*": ["public/img/*"] // 同步Vite中的img别名，确保VSCode能识别
    },
    "moduleResolution": "Node", // 核心配置：指定Node模块解析规则，兼容node_modules
    "module": "ESNext",
    "allowSyntheticDefaultImports": true // 适配ES模块的默认导入语法
  },
  "include": ["src/**/*", "public/**/*"], // 明确要解析的项目文件范围
  "exclude": ["node_modules", "dist"] // 排除无需解析的目录
}

关键配置说明 #

• moduleResolution: "Node"：强制VSCode使用Node.js的模块解析逻辑，这样就能正常识别node_modules中包的导出内容。
• 同步paths中的所有别名：和Vite配置保持完全一致，避免部分别名无法被编辑器识别。
• include/exclude：限定解析范围，减少VSCode的解析负担，同时确保项目内所有需要智能提示的文件都被覆盖。

后续验证步骤 #

1. 重启VSCode：修改配置后必须重启编辑器，让新配置生效。
2. 确认Vue插件状态：确保Vue Language Features (Volar)（适配Vue3的官方插件）处于启用状态，Vetur建议停用避免冲突。
3. 重启TS服务：如果仍有异常，按Ctrl+Shift+P打开命令面板，执行TypeScript: Restart TS Server重置编辑器的语言服务。

内容的提问来源于stack exchange，提问作者Liad Goren