npm link无法导入关联NPM库，npm pack却正常，求问题原因

可能的原因及对应解决方案 #

1. 库未执行构建，或package.json入口配置错误 #

npm pack会自动触发prepare脚本（若配置），通常该脚本会执行Rollup构建生成dist产物，但npm link不会自动执行构建操作。如果link前未手动执行构建，链接的库目录中就没有可被Vite识别的产物文件，自然会出现模块找不到的错误。

同时需检查库的package.json入口字段是否正确指向构建产物：

{
  "main": "dist/index.js",
  "module": "dist/index.esm.js",
  "types": "dist/index.d.ts",
  "files": ["dist"]
}

解决步骤：

• 先在库目录执行npm run build生成构建产物
• 确认package.json里的main/module/types路径指向dist目录下的文件，而非src目录的源文件

2. Vite对链接包的预构建冲突 #

Vite会预构建项目依赖以提升性能，但对于npm link的本地包，Vite可能无法正确识别，导致预构建失败，进而触发模块找不到的错误。

解决步骤：
在项目的vite.config.ts中配置optimizeDeps.exclude，跳过对链接库的预构建：

import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';

export default defineConfig({
  plugins: [react()],
  optimizeDeps: {
    exclude: ['@mjana/example-lib']
  }
});

若为开发模式，可尝试删除项目的node_modules/.vite缓存目录后重启Vite。

3. TypeScript路径解析问题 #

如果是TypeScript层面提示找不到模块，大概率是库的types字段配置错误，或项目的tsconfig未正确识别链接包的类型定义。

解决步骤：

• 确认库的package.json里的types字段指向正确的类型文件（如dist/index.d.ts）
• 检查项目的tsconfig.json，确保compilerOptions.moduleResolution为node或bundler，且未配置错误的paths导致解析失败
• 若问题仍存在，可在项目tsconfig中临时添加路径映射：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@mjana/example-lib": ["../example-lib/dist"]
    }
  }
}

4. npm link的包名匹配问题 #

确认库的package.json中name字段为@mjana/example-lib，与link时使用的包名完全一致（包括大小写）。若包名不匹配，npm link后项目也无法找到对应模块。

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