TypeScript模块解析路径配置报错：无法找到foo/foo-code模块

嘿，我来帮你捋清楚这个问题——你当前的tsconfig配置犯了一个很容易忽略的错误，导致路径别名完全没生效。

先还原你的场景：
你的项目目录结构：

projectRoot
├── src
│   └── app.ts
└── node_modules
    └── foo
        └── src
            └── foo
                └── foo-code.ts

你希望在app.ts里通过import fooCode from "foo/foo-code";导入模块，但编译时报错：error TS2307: Cannot find module 'foo/foo-code'。

问题根源 #

你的tsconfig里有一个关键错误：paths配置的位置不对。paths是compilerOptions的子属性，必须嵌套在compilerOptions内部才能被TypeScript识别，但你现在把它写到了和compilerOptions同级的位置，相当于这个配置完全没被读取。

修正后的正确配置 #

把paths移到compilerOptions里面就可以了，完整的tsconfig如下：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "*": ["src/*"],
      "foo/*": ["node_modules/foo/src/foo/*"]
    }
  }
}

配置说明 #

• baseUrl: "."：告诉TypeScript以项目根目录作为解析模块的基础路径。
• "foo/*": ["node_modules/foo/src/foo/*"]：这条规则会把foo/xxx格式的导入路径，自动映射到node_modules/foo/src/foo/xxx，正好匹配你要导入的foo-code.ts文件。
• "*": ["src/*"]：这条是用来简化src目录下模块的导入，比如你可以直接用import utils from "utils.ts"代替import utils from "./utils.ts"（假设src下有utils.ts）。

额外注意 #

如果你后续用webpack、Vite这类构建工具打包项目，记得在构建工具的配置里同步这个路径别名规则。比如webpack需要在resolve.alias里配置对应映射，Vite要在resolve.alias中设置相同的规则，否则打包阶段可能还是会出现模块找不到的问题。

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