如何从SvelteKit外部（命令行tsx）引用$lib

方案1：借助tsconfig-paths让tsx识别路径别名 #

tsx默认不会自动处理tsconfig中的paths配置，需要通过tsconfig-paths补全路径解析能力：

• 安装依赖：

npm install -D tsconfig-paths

• 确认根目录tsconfig.json的paths配置正确（SvelteKit初始化后通常已存在）：

{
  "compilerOptions": {
    "paths": {
      "$lib/*": ["src/lib/*"]
    }
    // 其他原有配置...
  }
}

• 运行util脚本时，通过node的-r参数加载注册器：

node -r tsconfig-paths/register -r tsx/esm ./util/your-script.ts

也可以把命令写到package.json的scripts里方便复用：

{
  "scripts": {
    "util:run": "node -r tsconfig-paths/register -r tsx/esm ./util/your-script.ts"
  }
}

方案2：创建独立的util脚本tsconfig文件 #

如果不想引入额外依赖，可以为util目录单独配置tsconfig：

• 在项目根目录创建tsconfig.util.json，继承根配置并明确包含需要解析的文件：

{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "module": "ESNext",
    "target": "ESNext",
    "moduleResolution": "NodeNext",
    "esModuleInterop": true,
    // 显式声明路径别名，确保继承配置生效
    "paths": {
      "$lib/*": ["src/lib/*"]
    }
  },
  "include": ["util/**/*", "src/lib/**/*"]
}

• 运行脚本时指定这个配置文件：

tsx --tsconfig ./tsconfig.util.json ./util/your-script.ts

方案3：临时hack（不推荐） #

如果上述正规方案都无法生效，可以用字符串替换的方式临时兼容：
在util脚本的最顶部添加以下代码，替换所有$lib引用为相对路径：

import { addHook } from 'pirates';

addHook((code) => {
  return code.replace(/from '\$lib\//g, "from '../src/lib/");
}, { exts: ['.ts', '.tsx'] });

注意：这个方案属于临时 workaround，可能存在边界情况，优先使用前两个方案。

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