开发TypeScript包仅需引用其他包类型时，是否需将其列入dependencies？

核心疑问解答 #

这种仅使用外部包类型定义、完全不涉及运行时代码调用的场景，绝对不可以把some-other-package加入你的包dependencies列表：

• 一旦加入dependencies，用户安装你的包时，npm会自动下载这个包的完整运行时代码，无意义地增加用户的安装体积，同时确实会误导用户，认为你的包在实际执行逻辑中依赖了这个包的能力。

现有代码的优化 #

你当前的写法使用的是普通值导入，哪怕只用到了类型，在部分编译配置下，这行导入可能会被保留到最终输出的JS文件中，平白产生无效的运行时依赖。
需要改成TypeScript专属的类型导入语法，从编译规则层面保证所有和该包相关的导入会被100%擦除：

// 用import type明确声明这行导入仅服务于类型场景
import type someOtherPackage from "some-other-package";
export const myFunction = (param: typeof someOtherPackage) =>
  JSON.stringify(param);

使用import type语法后，TypeScript编译输出的JS文件里不会出现任何和some-other-package相关的引用，完全不存在运行时依赖的问题。

正确的依赖配置 #

把some-other-package放到你项目的devDependencies列表即可：

• 这个配置只影响本地开发、类型检查、打包编译环节，能让你正常获取所需的类型定义来写代码
• 包发布到npm后，用户安装你的包时，npm不会拉取devDependencies里的内容，不会给用户增加额外的安装负担，也不存在误导问题

需要提前注意的细节 #

采用上述方案发布包后，你编译生成的.d.ts类型声明文件里，会保留对some-other-package的类型引用。如果用户的项目里没有安装some-other-package，调用myFunction时TypeScript会报找不到对应类型的错误：

• 这个表现是合理的：毕竟你的函数参数类型来源于some-other-package的结构，用户要正确传参，本来就需要匹配这个结构定义。你只需要在包的README文档里明确说明，使用myFunction需要用户自行在项目中安装some-other-package，即可获得完整类型提示。
• 如果不想强制用户安装这个包，也可以在文档中说明，只要传入符合对应结构的对象即可，不需要依赖这个包的实际运行逻辑。

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