如何在Vite初始化的Node.js项目中使用polars？

问题根源 #

报错“No loader is configured for ".node" files”是因为Vite默认未配置处理Node.js原生二进制模块（.node文件）的规则，而polars包的Node.js版本依赖这类文件。

解决方案步骤 #

1. 安装依赖 #

确保已安装polars及Vite相关依赖：

npm install polars
npm install --save-dev vite

2. 配置Vite处理.node文件 #

在项目根目录创建或修改vite.config.js，添加以下配置：

import { defineConfig } from 'vite'

export default defineConfig({
  optimizeDeps: {
    exclude: ['polars'], // 禁止Vite预构建polars，避免处理.node文件时出错
  },
  ssr: {
    external: ['polars'], // 标记polars为外部依赖，交由Node.js直接处理
  },
  resolve: {
    alias: {
      'polars': 'polars/nodejs', // 明确指向Node.js版本的polars
    },
  },
})

3. 正确导入Polars #

在main.js或script.js中使用标准导入语句：

// 命名导入
import * as pl from 'polars';
// 或默认导入
import pl from 'polars';

4. 验证运行 #

启动项目测试：

npm run dev

可通过以下代码验证功能正常：

const df = pl.DataFrame({
  name: ['Alice', 'Bob'],
  age: [25, 30],
});
console.log(df.toString());

额外说明 #

• 若为纯浏览器端项目，无需使用polars包，直接安装js-polars：npm install js-polars，导入时用import * as pl from 'js-polars'，无需配置Vite处理.node文件。
• 确保项目运行在Node.js环境下，Vite的Node.js模式需支持原生模块加载。

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