能否用相邻手动编写的d.ts文件自动为.js文件内部填充类型？

可以实现，核心是借助TypeScript语言服务的配置，让IDE识别JS文件并关联对应的.d.ts类型，全程不需要添加JSDoc，也不需要tsc执行类型检查：

1. 配置tsconfig.json（供IDE识别） #

在项目根目录创建tsconfig.json，添加以下配置：

{
  "compilerOptions": {
    "allowJs": true,
    "checkJs": false,
    "noEmit": true
  },
  "include": ["**/*.js", "**/*.d.ts"]
}

• allowJs: 让TypeScript工具链识别JS文件
• checkJs: 关闭强制类型检查，仅保留IDE提示能力
• noEmit: 完全禁用tsc的编译输出，符合纯JS项目需求
• include: 确保JS和对应的.d.ts文件都被纳入识别范围

2. 严格匹配文件命名与导出结构 #

确保.d.ts文件和目标JS文件同名同路径，且.d.ts的导出结构与JS文件完全一致：
比如泛型类的场景：

utils.d.ts #

export class DataWrapper<T> {
  data: T;
  constructor(data: T);
  getData(): T;
}

utils.js #

class DataWrapper {
  constructor(data) {
    this.data = data;
  }
  getData() {
    return this.data;
  }
}

export { DataWrapper };

此时在utils.js内部编写代码时，IDE会自动从相邻的utils.d.ts中读取泛型类型，给this.data、getData()等成员提供准确提示。

3. 关键注意事项 #

• 不要在JS文件中添加@ts-check注释或任何JSDoc类型声明，避免与.d.ts的类型规则冲突
• 模块语法要统一：如果JS用ESM的export/import，d.ts也要对应使用ESM语法；如果用CommonJS的module.exports，d.ts也要匹配
• 确保IDE启用了TypeScript语言服务（比如VS Code默认启用，无需额外安装全局TypeScript）

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