如何在SvelteKit中运行可调用$lib/$env的命令行维护脚本？

一、让命令行脚本支持$lib、$env导入的两种方案 #

1. 使用vite-node运行脚本（推荐） #

SvelteKit基于Vite构建，vite-node能自动识别SvelteKit的别名规则、环境变量配置，无需额外手动映射：

• 确保项目已安装vite-node（SvelteKit项目通常自带，缺失的话执行：npm install -D vite-node）
• 直接运行脚本：

npx vite-node src/scripts/myscript.js

此时脚本中可直接使用import { myUtil } from '$lib'或import { VITE_API_URL } from '$env/static/public'这类SvelteKit特有导入，vite-node会自动完成路径解析和环境变量注入。

2. 手动配置模块别名（适合轻量场景） #

如果不想依赖vite-node，可以用module-alias包手动映射路径，同时配合dotenv加载环境变量：

• 安装依赖：

npm install -D module-alias dotenv

• 在脚本头部添加初始化代码：

require('dotenv').config()
require('module-alias/register')

• 在项目根目录的package.json中添加别名映射：

"_moduleAliases": {
  "$lib": "./src/lib",
  "$env/static/public": "./src/env/static/public",
  "$env/dynamic/private": "./src/env/dynamic/private"
}

注意：这种方式需要自己处理环境变量的加载逻辑，无法自动复用SvelteKit对环境变量的过滤规则（比如仅暴露VITE_前缀的变量）。

二、SvelteKit特有模块导入的配置原理 #

SvelteKit的特有导入依赖Vite的别名系统和自身的模块封装：

• 预设别名注入：SvelteKit在启动时会向Vite自动注入预设别名，比如$lib映射到src/lib目录，$app/*（如$app/stores、$app/utils）映射到@sveltejs/kit包内的对应模块，$env/*映射到环境变量处理的内部逻辑。
• $env的特殊处理：$env/static/public和$env/dynamic/private是SvelteKit封装的环境变量导入方式，前者在构建时静态替换变量（仅暴露VITE_前缀的变量），后者在运行时动态读取私有环境变量，Vite负责加载.env、.env.local等环境文件并注入这些变量。
• 自定义扩展：你可以在svelte.config.js的vite.resolve.alias选项中添加自定义别名，扩展现有配置。

三、可用于命令行应用的SvelteKit功能 #

只有不依赖浏览器/客户端专属API的功能才能在Node.js命令行环境正常运行：

• 可用功能：
  • $lib目录下的纯逻辑模块（不含window、navigator、document等浏览器API）
  • $env下的环境变量（静态/动态导入均可，只要变量能在Node环境中读取到）
  • $app/utils中的通用工具函数（如generateSlug、format等无客户端依赖的方法）
• 不可用功能：
  • 所有浏览器DOM相关API（navigator、window、document等）
  • $app/navigation、$app/stores中的客户端专属store（如page、navigating）
  • $app/client下的所有模块
  • 需要浏览器环境的组件渲染、路由逻辑等

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