如何避免TypeScript模块从项目父目录而非node_modules解析？

这种情况我之前也碰到过，核心原因和TypeScript/Node.js的模块解析逻辑直接相关，下面拆解几个最可能的原因：

1. Node.js模块解析的默认优先级 #

当你使用非相对导入（比如import { something } from 'my-module/myFile'）时，TypeScript默认遵循Node.js的模块查找规则：

• 从当前文件所在目录开始，先查找是否存在my-module文件夹（或对应文件）
• 如果找不到，才会去当前目录的node_modules里找
• 若还是找不到，会继续向上遍历父目录，先检查父目录下的my-module文件夹，再检查父目录的node_modules，直到系统根目录

所以如果你的项目父目录刚好有一个同名的my-module文件夹，Node.js/TypeScript会优先把它当作模块加载，而不是当前项目node_modules里的版本。

2. tsconfig.json的配置干扰 #

如果你的tsconfig.json里配置了baseUrl或者paths，可能会改变模块解析的路径优先级：

• 比如paths里写了"my-module/*": ["../my-module/*"]，这会强制TypeScript把所有my-module/xxx的导入映射到父目录的对应文件
• 或者baseUrl设为了父目录，也会让TypeScript优先在父目录下查找模块

3. 父目录的模块包含合法的package.json #

如果父目录的my-module文件夹里有自己的package.json（哪怕很简单，比如只定义了name字段），TypeScript会识别它为一个合法的npm模块，进一步强化了优先加载它的逻辑。

怎么解决这个问题？ #

根据你的需求，这里有几个可行的方案：

• 强制指定当前项目的node_modules路径：用相对导入直接指向当前项目的node_modules，比如import { something } from './node_modules/my-module/myFile'，不过这种写法不够优雅，而且如果目录结构变动容易出问题
• 修改tsconfig.json的paths配置：在compilerOptions里添加paths规则，强制TypeScript优先解析当前项目的node_modules：

  {
    "compilerOptions": {
      "paths": {
        "my-module/*": ["./node_modules/my-module/*"]
      }
    }
  }
  

• 重命名父目录的本地模块：最简单直接的方法，把父目录的my-module改个名字（比如my-module-local），避免和npm模块名冲突
• 检查NODE_PATH环境变量：如果你的系统里设置了NODE_PATH且包含父目录，会影响模块查找优先级，可以尝试清空这个环境变量再测试

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