SvelteKit组件包导入时报类型声明错误，组件可正常运行求助

问题背景 #

开发了一个Svelte组件并发布到npm，在SvelteKit项目的+page.svelte中导入组件时，TypeScript提示错误：

Cannot find module 'svelte-combobox/ComboBox.svelte' or its corresponding type declarations.

但组件实际能正常渲染运行，项目构建也无报错。已遵循SvelteKit官方打包文档配置，怀疑问题出在package.json的exports字段，但无法定位具体原因。

导入代码（+page.svelte） #

<script lang="ts">
    import ComboBox from 'svelte-combobox/ComboBox.svelte';
    let options = [
        { id: 1, name: "Option 1", value: "1" },
        { id: 2, name: "Option 2", value: "2" },
        { id: 3, name: "Option 3", value: "3" },
        { id: 4, name: "Option 4", value: "4" },
        { id: 5, name: "Option 5", value: "5" },
        { id: 6, name: "Option 6", value: "6" },
        { id: 7, name: "Option 7", value: "7" },
        { id: 8, name: "Option 8", value: "8" },
        { id: 9, name: "Option 9", value: "9" },
        { id: 10, name: "Option 10", value: "10" }
    ] 
</script>

<ComboBox options={options} id="1" on:select={(e)=>{console.log(e.detail)}}/>

当前package.json exports配置 #

{
  "exports": {
    "./ComboBox.svelte": {
      "types": "./dist/ComboBox.svelte.d.ts",
      "svelte": "./dist/ComboBox.svelte"
    }
  }
}

修复方案 #

1. 完善package.json的exports与类型映射 #

TypeScript对Svelte模块的解析需要更明确的配置，补充import/require字段，并添加typesVersions确保类型文件被正确识别：

{
  "exports": {
    "./ComboBox.svelte": {
      "types": "./dist/ComboBox.svelte.d.ts",
      "svelte": "./dist/ComboBox.svelte",
      "import": "./dist/ComboBox.svelte",
      "require": "./dist/ComboBox.svelte"
    }
  },
  "typesVersions": {
    "*": {
      "ComboBox.svelte": ["dist/ComboBox.svelte.d.ts"]
    }
  }
}

2. 检查类型文件生成情况 #

确认dist/ComboBox.svelte.d.ts文件存在且内容正确。如果使用svelte-package打包，确保组件的props、事件等类型被正确导出，没有遗漏。

3. 项目中添加TypeScript路径映射（临时修复） #

如果修改包配置后仍有提示，可在项目的tsconfig.json中添加路径映射，强制TypeScript找到模块：

{
  "compilerOptions": {
    "paths": {
      "svelte-combobox/ComboBox.svelte": ["node_modules/svelte-combobox/dist/ComboBox.svelte"]
    }
  }
}

4. 重启TypeScript服务 #

VS Code的TypeScript服务可能缓存了旧配置，按Ctrl+Shift+P（Windows）/Cmd+Shift+P（Mac），选择「TypeScript: Restart TS Server」即可刷新缓存。

内容的提问来源于stack exchange，提问作者Sourabh Patel