TypeScript本地共享NPM包导入失败：无法找到共享类及无智能提示

嘿，我一眼就看出你这问题出在TypeScript类型系统的模块配置上——这可是新手做本地共享TS包时最容易踩的坑！咱们一步步来补全遗漏的配置：

1. 给共享包的package.json添加类型入口 #

TypeScript需要明确知道你的包的类型定义文件在哪，这是核心！打开sharedcomponents的package.json，添加types字段，指向你的类型文件：

{
  "name": "sharedcomponents",
  "version": "1.0.0",
  "main": "index.js",
  "types": "./shared.d.ts" // 关键！告诉TS类型文件的位置
}

如果你的共享包是用tsc编译的（推荐），可以把types指向编译后生成的.d.ts文件，比如"./dist/index.d.ts"，同时把main改成编译后的JS入口。

2. 确保类型文件正确导出TextButton #

检查shared.d.ts里的TextButton类是不是用export导出的——全局声明是没用的，必须是模块级别的导出：

// shared.d.ts 正确写法
export class TextButton {
  // 你的类属性和方法
}

要是你是直接编译TS源码生成.d.ts，记得在TS源码里就用export导出类，tsc会自动把导出同步到类型文件里。

3. 删掉主项目里手动加的reference引用 #

你在tsd.d.ts里加的/// <reference path="../../sharedcomponents/shared.d.ts" />反而会干扰TypeScript的模块解析逻辑。当共享包的package.json配置了types字段后，TS会自动通过本地链接的包（npm会把file:路径的包软链到node_modules）找到类型文件，所以这行可以删掉了。

4. 给共享包开启自动生成类型文件（可选但推荐） #

如果你的共享包是用TypeScript写的，一定要在它的tsconfig.json里开启declaration选项，这样编译时会自动生成对应的.d.ts文件，确保类型和JS代码完全匹配：

// sharedcomponents/tsconfig.json
{
  "compilerOptions": {
    "declaration": true, // 自动生成类型文件
    "outDir": "./dist", // 编译产物输出目录
    "module": "commonjs", // 和你的index.js里的module.exports匹配
    "target": "es6"
  }
}

之后把共享包的main和types都指向dist目录下的文件，这样结构更规范。

5. 重启IDE并清理依赖缓存 #

最后，在主项目里重新执行npm install，然后重启你的IDE（比如VSCode）——因为IDE的TypeScript语言服务有时候会缓存旧的类型信息，重启后才能加载新的配置。

做完这些，你再试试import * as SharedComponents from 'sharedcomponents'，应该就能看到TextButton的智能提示，编译器也不会报错了！

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