如何在NX.dev monorepo中配置绝对路径

步骤1：定位正确的配置文件 #

NX为每个库项目生成专属的构建配置文件，你需要修改库项目目录下的tsconfig.lib.json（而非根目录tsconfig或测试用的tsconfig.spec.json）。如果你的库是通过nx g library mylibrary创建的，该文件位于libs/mylibrary/目录下。

步骤2：修正路径别名配置 #

根据你的库目录结构调整配置：
假设你的库结构为：

libs/mylibrary/
├─ src/
│  ├─ lib/
│  │  ├─ components/
│  │  └─ core/
├─ tsconfig.lib.json

则tsconfig.lib.json的配置应修改为：

{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "baseUrl": "./src",
    "paths": {
      "@/components/*": ["lib/components/*"],
      "@/core/*": ["lib/core/*"]
    },
    // 保留原有其他compilerOptions配置
    "jsx": "react-jsx",
    "allowJs": false,
    "esModuleInterop": false,
    "allowSyntheticDefaultImports": true,
    "strict": true,
    "types": ["vite/client"]
  },
  "exclude": [
    "jest.config.ts",
    "src/**/*.spec.ts",
    "src/**/*.test.ts"
  ],
  "include": ["src/**/*"]
}

如果你的库放在项目根目录的src/lib下（非NX标准结构），则需修改根目录的tsconfig.base.json：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/components/*": ["src/lib/components/*"],
      "@/core/*": ["src/lib/core/*"]
    },
    // 保留原有全局配置
  }
}

步骤3：清除NX缓存并验证 #

1. 执行nx reset清除NX缓存，避免旧配置残留
2. 重启Dev Server（如果正在运行）
3. 在组件文件中测试绝对路径导入：

import Input from '@/components/Input';
import utils from '@/core/utils';

4. 执行nx lint mylibrary或nx test mylibrary验证路径是否生效

常见误区提醒 #

• 无需修改所有自动生成的tsconfig文件，仅需关注构建用的tsconfig.lib.json和全局tsconfig.base.json
• 路径映射的相对路径必须与baseUrl配合，paths数组内的路径是相对于baseUrl的位置
• 构建无报错不代表路径配置生效，必须通过lint、测试或运行应用验证

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