Svelte组件库后端依赖better-sqlite3在SvelteKit构建时的打包问题咨询

1. 不修改应用package.json，强制Vite不打包后端依赖的方法 #

你可以通过配置Vite的外部依赖规则，让它跳过对better-sqlite3的打包，直接使用node_modules中的依赖文件。具体操作是在SvelteKit应用的vite.config.js中添加以下配置：

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

export default defineConfig({
  plugins: [sveltekit()],
  // 构建时将better-sqlite3标记为外部依赖
  build: {
    rollupOptions: {
      external: ['better-sqlite3']
    }
  },
  // 开发环境下排除该依赖的预优化
  optimizeDeps: {
    exclude: ['better-sqlite3']
  }
});

这个配置会告诉Vite：无论是开发还是构建阶段，都不要把better-sqlite3打包进产物，而是保留原生的导入语句，运行时直接加载node_modules中的对应包——因为你的组件库已经将better-sqlite3声明为依赖，应用安装组件库时会自动把它拉取到本地node_modules。

2. 后端依赖的最佳实践及相关方案 #

核心原则：区分前后端代码边界 #

SvelteKit是全栈框架，组件库中的后端逻辑必须确保只在服务器端执行，避免被打包到客户端代码中：

• 在组件库的后端模块顶部添加import 'server-only';，Vite会自动拦截客户端对该模块的导入，防止后端依赖泄漏到前端。
• 用package.json的exports字段明确拆分前后端入口，比如：

  {
    "exports": {
      ".": "./dist/client.js",
      "./server": "./dist/server.js"
    }
  }
  

  应用端仅在服务器路由/加载函数中导入your-lib/server，确保后端依赖只在服务端被处理。

让依赖进入构建产物但不优化的方案 #

如果需要将后端依赖包含在构建产物中但不做ES模块转换/优化，可以调整Vite的CommonJS兼容配置：

export default defineConfig({
  plugins: [sveltekit()],
  build: {
    commonjsOptions: {
      // 不对better-sqlite3做ES模块转换
      exclude: ['better-sqlite3'],
      // 处理混合模块场景
      transformMixedEsModules: true
    }
  }
});

另外，也可以用动态导入的方式延迟加载后端依赖，避免打包时被处理：

// 仅在服务器端执行的函数
async function initDatabase() {
  const { default: betterSqlite3 } = await import('better-sqlite3');
  return betterSqlite3('./data.db');
}

依赖声明规范 #

组件库中应将better-sqlite3放在dependencies而非devDependencies中，确保应用安装组件库时自动拉取该依赖，无需手动添加到应用的package.json。

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