如何配置VS Code以支持install-local安装包的自动导入提示？

1. 依赖字段不兼容：install-local工具安装本地包时，会将包信息写入package.json的非标准localDependencies字段，而非TypeScript语言服务默认识别的dependencies/devDependencies等标准字段。
2. 自动导入的扫描逻辑：VS Code的TypeScript服务生成自动导入建议时，优先读取package.json的标准依赖字段来确定候选包，不会主动解析localDependencies，因此不会触发该包的自动导入提示。
3. 手动输入的特殊逻辑：手动编写import {} from ''并输入包名时，VS Code会直接扫描node_modules目录下的实际包文件，所以能正常给出提示——这和自动导入的扫描逻辑不同。

方法一：同步依赖声明到标准字段 #

在package.json的dependencies中添加该包的占位声明（无需实际安装，因为install-local已经把包放到node_modules了）：

{
  "dependencies": {
    "@joonashak/nestjs-clone-bay": "*"
  },
  "localDependencies": {
    "@joonashak/nestjs-clone-bay": "../lib"
  }
}

添加后，TypeScript服务会从dependencies识别到该包，自动导入提示即可正常工作。注意不要运行npm install，避免覆盖本地安装的包。

方法二：配置tsconfig.json强制扫描目标包 #

通过tsconfig.json的paths和include字段，让TypeScript明确识别该包的位置：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@joonashak/nestjs-clone-bay": ["node_modules/@joonashak/nestjs-clone-bay"]
    }
  },
  "include": [
    "src/**/*",
    "node_modules/@joonashak/nestjs-clone-bay/**/*"
  ]
}

此方法会让TypeScript扫描node_modules中的目标包，从而触发自动导入提示，但可能会略微增加编译扫描的开销。

方法三：改用npm link替代install-local（可选） #

如果install-local的peer依赖问题可以通过npm link解决，可切换为软链接方式：

1. 在本地库目录执行：npm link
2. 在项目目录执行：npm link @joonashak/nestjs-clone-bay
   这种方式会将包以软链接形式放入node_modules，同时package.json的dependencies会保留正常的包声明，VS Code的自动导入提示自然正常，还能避免peer依赖重复问题。

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