如何修复NestJS项目中的导入相对路径问题？

问题场景 #

在开发NestJS项目时，创建UserService时出现导入路径错误，相关代码如下：

import { Injectable } from '@nestjs/common';
import { InjectRepository } from "@nestjs/typeorm"; 
import { UserDto } from 'src/user/dto/user.dto'; 
import { Repository } from "typeorm"; 
import { UserEntity } from './../../entity/user.entity';

@Injectable()
export class UserService { 

constructor( 
@InjectRepository(UserEntity) private userRepository: Repository<UserEntity> 
){}
 
create(user: UserDto): Promise<UserDto> {
   return this.userRepository.save(user); 
 }
 findAll(): Promise<UserDto[]> {
   return this.userRepository.find(); 
 } 
}

错误导入语句 #

问题出在以下两行导入：

import { UserDto } from 'src/user/dto/user.dto';

import { UserEntity } from './../../entity/user.entity';

错误截图 #

相关代码片段 #

UserDto代码 #

import { IsNumber, IsString } from 'class-validator';
export class UserDto { 
@IsNumber() id: number;
@IsString() name: string;
@IsString() lastName: string; 
}

UserEntity代码 #

import { Column, Entity, PrimaryGeneratedColumn } from 'typeorm';
@Entity() 
export class UserEntity { 

@PrimaryGeneratedColumn() 
id: number;

@Column({ nullable: false }) 
name: string;

@Column({ name: 'last_name', nullable: false }) 
lastName: string; 
}

疑问 #

教程中采用相同导入规则无报错，但当前项目出现错误，是否遗漏了配置？是否需要改用绝对路径？完整项目结构已明确，如需补充信息可提供。

问题原因与修复方案 #

原因分析 #

1. 绝对路径未配置：src/user/dto/user.dto这类以src开头的绝对路径需要TypeScript配置baseUrl才能识别，否则编译器无法将src解析为项目根目录的一部分。
2. 相对路径可能存在层级误差：./../../entity/user.entity的层级计算可能与实际项目目录结构不匹配，或者因操作系统大小写敏感问题导致文件查找失败。

修复步骤 #

方案一：配置TypeScript绝对路径（推荐）

修改项目根目录下的tsconfig.json文件，在compilerOptions中添加以下配置：

{
  "compilerOptions": {
    "baseUrl": "./src",
    "paths": {
      "@/*": ["*"]
    },
    // 保留原有其他配置
  },
  "include": ["src/**/*"]
}

配置完成后，导入语句可简化为：

import { UserDto } from '@/user/dto/user.dto';
import { UserEntity } from '@/entity/user.entity';

方案二：修正相对路径

根据实际项目目录结构调整相对路径，确保路径指向正确的文件。同时检查文件名和路径的大小写是否与实际文件一致（Linux/macOS环境需严格区分）。

额外检查 #

• 确认tsconfig.json的include字段包含所有需要编译的源码文件，例如"include": ["src/**/*"]；
• 若使用IDE（如VS Code），可重启IDE让配置生效，避免缓存导致的识别错误。

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