Vite能否在插件中解析路径别名？SvelteKit场景遇导入错误

问题背景 #

在Vite插件的configureServer钩子中导入的文件里使用$lib路径别名时，出现模块找不到的错误，添加Vite的resolve.alias配置也无法解决，想确认该需求是否可行。

项目代码 #

vite.config.ts #

import { sveltekit } from '@sveltejs/kit/vite';
import { defineConfig, type ViteDevServer } from 'vite';

const xServer = {
    name: 'xServer',
    async configureServer(server: ViteDevServer) {              
        const { doX } = await import('./src/lib/x');
        doX(server)
    }
}

export default defineConfig({
    plugins: [xServer, sveltekit()],
});

src/lib/x.ts #

import { doY } from "$lib/y";
import type { ViteDevServer } from "vite";

export async function doX(devServer: ViteDevServer) {
   doY()
   // 其他业务逻辑
}

报错信息 #

Error [ERR_MODULE_NOT_FOUND]: Cannot find package '$lib' imported from ...vite.config.ts

尝试过的方案 #

曾在Vite配置中添加别名规则，但未生效：

resolve: {
   alias: {
      '$lib': path.join(__dirname, 'src/lib'),
    },
}

可行方案解析 #

Vite的resolve.alias仅对Vite编译处理的业务代码生效，而configureServer中通过import加载的文件属于Node.js直接执行的代码（vite.config.ts本身运行在Node环境），所以Vite的别名规则不会作用于这部分代码。

要解决该问题，有两种实用思路：

1. 给Node环境配置别名 #

使用module-alias包让Node.js识别$lib别名：

• 安装依赖：npm install module-alias --save-dev
• 在vite.config.ts顶部添加配置：

import { addAlias } from 'module-alias';
import path from 'path';

addAlias('$lib', path.join(__dirname, 'src/lib'));

2. 改用相对路径导入 #

直接在x.ts中使用相对路径替代别名：

// src/lib/x.ts
import { doY } from './y';

这种方式无需额外依赖，简单直接。

关键说明 #

SvelteKit内置的$lib别名仅对其编译的业务代码（组件、路由、业务逻辑文件等）生效，不会影响Node环境执行的配置文件及插件代码。

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