调用fs.readFileSync触发TypeError提示不是函数的问题求助

• 最本质的环境不匹配问题：fs是Node.js专属的内置文件系统模块，浏览器运行环境的JS沙箱没有权限、也不存在这个原生模块。如果你的项目是前端Web工程，通过Webpack/Vite等工具打包后跑在浏览器端，哪怕你写了require('fs')，实际拿到的也是被打包工具裁剪后的残缺空对象，根本不存在readFile/readFileSync这类方法，自然会抛出「is not a function」的类型错误。
• 你的代码本身存在逻辑bug，就算切换到正确的Node环境运行，原代码也会报错：fs.readFile是带回调的异步API，没有加await、没有传错误/成功回调的情况下，方法执行后直接返回undefined，你对undefined调用toString()方法本身就会触发类型错误；同时代码里创建的Promise没有添加错误捕获分支，一旦流程异常就会抛出未处理的Promise拒绝，和你看到的Unhandled Rejection提示完全对应。
• 补充说明：报错提示的方法名可能和你实际代码里调用的不一致，不管是readFile还是readFileSync，只要当前运行环境不是Node.js，fs对象本身就没有挂载这些方法，都会触发同类的类型错误。

场景1：代码运行在Node.js环境（本地脚本/后端服务） #

按照Node.js的API规范修正代码逻辑，不要依赖浏览器环境的无效polyfill：

// 引入Promise版本的fs模块，避免嵌套回调
const fs = require('fs/promises')
const Papa = require('papaparse')

const readCSV = async (filePath) => {
  // 读取文件为Buffer格式
  const csvBuffer = await fs.readFile(filePath)
  // 转成UTF-8编码的文本内容
  const csvText = csvBuffer.toString('utf-8')

  return new Promise((resolve, reject) => {
    Papa.parse(csvText, {
      header: true,
      complete: (results) => {
        console.log('解析完成，共读取到', results.data.length, '条记录')
        resolve(results.data)
      },
      // 补充错误捕获，避免未处理的Promise异常
      error: (err) => reject(err)
    })
  })
}

// 测试调用
const test = async () => {
  try {
    // 替换为实际的CSV文件路径
    const csvFilePath = './local.csv'
    const parsedData = await readCSV(csvFilePath)
    console.log('解析结果：', parsedData)
  } catch (err) {
    console.error('CSV解析流程失败：', err)
  }
}

test()

注意事项：

• 不要在前端打包工程里强行给fs模块打浏览器端的polyfill，这类实现不仅有安全风险，生产构建时也会被打包工具拦截
• 如果要使用readFileSync同步方法，只需要把fs.readFile替换为fs.readFileSync即可，去掉对应的await逻辑就行，适合小体量本地脚本的快速读写

场景2：代码运行在浏览器前端页面 #

浏览器出于安全限制，不允许JS直接通过本地磁盘路径读取任意文件，必须通过用户手动上传的交互获取文件内容，全程不需要引入fs模块：

import Papa from 'papaparse'

// 绑定页面的文件选择框
const uploadInput = document.querySelector('#csv-file-input')
uploadInput.addEventListener('change', (e) => {
  const selectedFile = e.target.files[0]
  if (!selectedFile) return

  // 直接把File对象传给Papa解析
  Papa.parse(selectedFile, {
    header: true,
    complete: (results) => {
      console.log('前端CSV解析完成，共读取到', results.data.length, '条记录')
      console.log('解析结果：', results.data)
    }
  })
})

对应页面只需要加一个原生文件选择框即可：

<input type="file" id="csv-file-input" accept=".csv" />

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