Tauri+Svelte项目中TypeScript IntelliSense无法识别绝对路径导入

问题背景 #

在Tauri + Svelte项目中，遇到以下异常：

• .ts文件使用@folder/my_test_file这类绝对路径导入时，VS Code IntelliSense提示错误：Cannot find module '@folder/my_test_file' or its corresponding type declarations，但代码实际编译运行完全正常。
• .svelte文件使用相同的绝对路径导入无任何问题，自动补全功能也正常。
• 已完成的操作：配置tsconfig.json的baseUrl与paths，安装vite-tsconfig-paths、TypeScript Hero工具，重启TypeScript Server，尝试常见解决方案均无效。
• 额外观察：
  • 相对路径导入在.ts文件中正常工作；
  • 修改tsconfig.json后，IntelliSense会动态更新，但项目需重启VS Code窗口才生效；
  • .svelte文件无需配置paths，直接用src/开头的绝对路径导入即可。

可能原因 #

这并非Tauri或TypeScript的核心Bug，主要是VS Code的TypeScript语言服务与Vite/Svelte的路径解析逻辑不匹配导致：

• .svelte文件由Svelte Language Server处理，它能自动识别Vite的路径规则；而.ts文件由VS Code内置的TypeScript Language Server处理，若配置存在隐性问题，会导致无法正确读取路径映射。
• vite-tsconfig-paths仅在编译阶段生效，不会直接影响VS Code的IntelliSense；TypeScript Hero这类插件可能存在兼容性问题，反而干扰默认的路径解析逻辑。

解决步骤 #

1. 修正tsconfig.json配置 #

确保baseUrl和paths配置准确，且tsconfig.json位于项目根目录，示例配置如下：

{
  "compilerOptions": {
    "baseUrl": "./src",
    "paths": {
      "@folder/*": ["folder/*"]
    },
    "target": "ESNext",
    "module": "ESNext",
    "moduleResolution": "Node",
    "resolveJsonModule": true,
    "esModuleInterop": true
  },
  "include": ["src/**/*.ts", "src/**/*.svelte"],
  "exclude": ["node_modules", ".svelte-kit", "dist"]
}

注意事项：

• baseUrl需指向实际源码目录（如./src）；
• paths中的映射要与项目实际目录结构完全对应；
• include必须覆盖所有.ts和.svelte文件。

2. 切换VS Code至项目本地TypeScript版本 #

VS Code默认使用内置TypeScript版本，与项目依赖版本不一致会引发解析问题：

• 打开任意.ts文件，点击右下角的TypeScript版本号；
• 在弹出菜单中选择Use Workspace Version。

3. 重置TypeScript Language Server #

缓存问题可能导致配置不生效：

• 按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac）打开命令面板；
• 输入TypeScript: Restart TS Server并执行；
• 若仍无效，删除.vscode/settings.json中可能干扰的插件配置（如TypeScript Hero相关设置），再重启VS Code。

4. 配置svelte.config.js关联tsconfig #

确保Svelte配置正确读取tsconfig规则，示例svelte.config.js：

import { vitePreprocess } from '@sveltejs/vite-plugin-svelte';

export default {
  preprocess: vitePreprocess({
    typescript: {
      tsconfigFile: './tsconfig.json'
    }
  })
};

5. 禁用冲突插件 #

暂时禁用TypeScript Hero这类路径相关插件，避免其覆盖VS Code默认的路径解析逻辑。

内容的提问来源于stack exchange，提问作者Ólavur Nón