如何让nuxt.config.ts识别import语句中的路径别名？

问题本质：nuxt.config.ts 会在Nuxt实例初始化之前被Node.js直接加载，此时你在NuxtConfig.alias中配置的别名、以及tsconfig.json的paths规则都未生效，Node.js本身默认不识别TypeScript路径别名配置，因此会抛出模块找不到的错误，哪怕是相对路径导入的模块内部使用别名也会触发该问题。

解决方案1：使用Node.js原生子路径导入（无额外依赖，推荐） #

Node.js 14及以上版本原生支持package.json的imports字段，配置后运行时会直接识别别名，无需安装任何工具，适配所有场景。
操作步骤：

• 在项目根目录的package.json中新增imports字段，按照你的别名规则配置：

{
  "name": "your-project",
  "imports": {
    "@Environment/*": "./Environment/*",
    "@Utils/*": "./Utils/*"
    // 其余别名按相同格式补充
  }
}

注意：路径必须以./开头，相对于package.json所在的项目根目录。

• 同步tsconfig.json中的paths配置，保证类型检查和运行时路径一致：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@Environment/*": ["./Environment/*"],
      "@Utils/*": ["./Utils/*"]
      // 其余别名同步补充
    }
  }
}

• 删除项目下的.nuxt、node_modules/.cache缓存目录，重新执行nuxt dev即可。

解决方案2：使用tsconfig-paths兼容旧版Node #

如果你的Node版本低于14，可以通过tsconfig-paths工具让Node运行时加载tsconfig.json的路径别名配置。
操作步骤：

• 安装开发依赖：

npm i -D tsconfig-paths

• 在nuxt.config.ts的最顶部第一行引入注册代码，必须放在所有使用别名的导入语句之前：

import 'tsconfig-paths/register'
// 后续才可以使用别名导入
import EnvironmentVariables from "@Environment/EnvironmentVariables";
import RawObjectDataProcessor from "@Utils/RawObjectDataProcessor/RawObjectDataProcessor";

export default defineNuxtConfig({
  // 你的nuxt配置
})

• 确认tsconfig.json的baseUrl和paths配置正确，清理缓存后重启项目即可。

内容的提问来源于stack exchange，提问作者Takeshi Tokugawa YD