SvelteKit中无法导入goto模块的TypeScript报错问题

API 探路者

2026-8-8

解决SvelteKit中$app/navigation模块找不到的TypeScript错误

可行的解决步骤：

更新SvelteKit及相关依赖
旧版本SvelteKit可能存在类型定义缺失问题，执行命令更新到最新稳定版，同时保证svelte与@sveltejs/kit版本兼容：
```
npm install @sveltejs/kit@latest svelte@latest
```
检查tsconfig.json配置
确保项目根目录的tsconfig.json正确继承SvelteKit自动生成的类型配置，示例如下：
```
{
  "extends": "./.svelte-kit/tsconfig.json",
  "compilerOptions": {
    "types": ["@sveltejs/kit"]
  }
}
```
注意：.svelte-kit是SvelteKit自动生成的目录，不要手动删除或修改其中内容，确认该目录存在。
重新生成类型定义文件
执行SvelteKit的构建或开发命令，让框架重新生成完整的类型文件：
```
npm run build
# 或启动开发服务，也会自动生成类型
npm run dev
```
清理编辑器缓存
编辑器（如VS Code）可能缓存旧的类型信息，尝试重启编辑器，或者在VS Code命令面板中执行TypeScript: Restart TS Server命令。
确认导入场景
$app/navigation仅能在Svelte组件或SvelteKit路由模块中使用，无法在普通.ts工具文件中直接导入。如果需要在非组件文件中实现导航，可通过page store或传递导航函数的方式处理。