教程文档【免费下载链接】30-seconds-of-codeCoding articles to level up your development skills项目地址https://gitcode.com/gh_mirrors/30/30-seconds-of-code点击查看免费下载文本文件的读取与解析是服务端编程中出现频率最高的任务之一。本指南以 30 seconds of code 仓库中的 read-file-lines.md 为骨架系统讲解如何使用 Node.js 内置fs模块同步或异步读取文本文件并通过String.prototype.split()将其转换为字符串行数组。读完本文你将掌握fs.readFileSync()、fs.readFile()、fs/promises的完整用法理解Buffer与编码的关系并能处理换行符跨平台差异等真实工程问题。读取文本文件的两条路径同步 vs 异步Node.js 提供两套读取文件的核心 API选择哪一套取决于你的运行场景fs.readFileSync()同步读取会阻塞事件循环event loop。适用于脚本启动阶段、一次性配置加载等对性能不敏感的场景。fs.readFile()异步读取非阻塞基于回调配合fs/promises下的同名方法则直接返回Promise。适用于 Web 服务器等需要保持高并发响应的场景。从该集合的定位看Node.js 文章集合明确面向Node.js 18.x且所有示例统一使用ESM 语法因此下面的示例均以import方式引入模块。import { readFileSync } from fs; import { readFile } from fs/promises;Buffer 与编码读懂原始返回值两个 API 读取文件后默认返回的都是Buffer对象——这是 Node.js 处理二进制数据的核心类型。要得到可读的文本有两个等价途径调用Buffer.prototype.toString()并可传入编码名称作为参数在调用读取方法时把编码作为第二个参数传入直接返回字符串。readFileSync(test.txt).toString(UTF8); // line1\nline2\nline3\n readFile(test.txt, UTF8); // line1\nline2\nline3\n注意即使指定了编码fs/promises版本的readFile()返回的仍然是一个Promise需要用then或await取回字符串readFile(test.txt).then(data data.toString()); // Promise {line1\nline2\nline3\n} readFile(test.txt, UTF8); // Promise {line1\nline2\nline3\n}编码名称推荐统一写作UTF8等价于utf8Node.js 对大小写不敏感。除 UTF-8 外fs读取还支持ascii、utf16le、latin1、base64、hex等常见编码按文件实际内容选择即可。从文件内容到行数组split 是关键一步拿到文件内容的字符串后将其转换为数组只需要一个 APIString.prototype.split()。文本文件中的行由换行符分隔因此按换行符\n分割即可const fileContents line1\nline2\nline3\n; fileContents.split(\n); // [line1, line2, line3]值得注意的细节是字符串以\n结尾时split(\n)产生的数组中不会包含尾部的空字符串元素line3之后不再有多余的空串。但如果文件内容以换行符开头或存在连续空行数组中将出现空字符串元素这是split的正常行为下文会讨论如何处理。异步读取行数组把“读取”和“分割”两个步骤串联起来即可得到一个返回Promisestring[]的异步函数。注意readFile(path, UTF8)返回的Promise在 resolve 时已经是字符串因此data.split(\n)直接可用import { readFile } from fs/promises; const readFileLines path readFile(path, UTF8).then(data data.split(\n)); readFileLines(test.txt).then(lines console.log(lines)); // [line1, line2, line3]调用方既可以使用Promise.prototype.then()如上也可以在 async 函数内使用awaitconst lines await readFileLines(test.txt); console.log(lines); // [line1, line2, line3]同步读取行数组如果你更偏爱同步代码例如在脚本初始化阶段可以直接使用fs.readFileSync()。此时readFileSync已经通过编码参数返回字符串toString()在此处其实是冗余保险——去掉它结果完全一致但保留可以让意图更明确、也兼容某些返回Buffer的调用写法import { readFileSync } from fs; const readFileLinesSync path readFileSync(path, UTF8).toString().split(\n); const lines readFileLinesSync(test.txt); console.log(lines); // [line1, line2, line3]同步版本的返回值可以直接使用无需处理Promise在顶层模块或函数体内均可直接赋值。真实工程中的边界情况换行符与空行split(\n)假设文件使用 Unix 风格换行LF。但现实中的文本文件可能来自 Windows\r\nCRLF甚至老式 Mac\r。仓库中的 normalize-line-endings.md 专门讨论了这一问题不同操作系统历史上使用不同字符表示换行跨平台处理文本时必须留意。对读取行数组的场景有两种稳妥做法先规范化再分割用String.prototype.replace()配合正则/\r?\n/g把 CRLF 统一为 LF再执行split(\n)const normalizeLineEndings (str, normalized \n) str.replace(/\r?\n/g, normalized); normalizeLineEndings(line1\r\nline2\r\nline3\r\n).split(\n); // [line1, line2, line3]直接按更宽泛的正则分割使用split(/\r?\n/)一条正则同时兼容 LF 与 CRLF是最简洁的跨平台写法。如需兼容极老的\r单独换行可扩展为split(/\r\n|\n|\r/)。另一个常见诉求是过滤空行。若文件中有连续空行或行尾存在多余空白得到的结果数组可能混入空字符串元素可在分割后追加过滤const readFileLinesSync path readFileSync(path, UTF8).split(/\r?\n/).filter(line line.trim() ! );仓库内配套参考读写一体的文件操作闭环30 seconds of code 仓库围绕fs模块提供了成体系的配套方案可与本主题组合成完整的文件操作链路写文件json-to-file.md 展示了fs.writeFileSync()的用法——用JSON.stringify(obj, null, 2)序列化对象后写入.json文件与本文的读取方案正好构成“序列化写入 / 读取解析”的闭环。目录准备create-directory-if-not-exists.md 提供了异步fs.access()fs.mkdir()与同步fs.existsSync()fs.mkdirSync()两种“不存在则创建目录”的实现是读取文件前保障路径可用性的前置步骤。服务端实战nodejs-static-file-server.md 中fs.readFile()被用于实现一个约 70 行的静态文件服务器——它演示了异步读取在真实 I/O 密集场景中的应用每个请求通过回调读取磁盘文件并返回响应同时结合path模块做路径归一化与目录穿越防护。这正是“异步非阻塞读取”价值的典型体现。小结两条路径如何选维度异步readFilefs/promises同步readFileSync返回类型Promisestring指定编码时string事件循环影响非阻塞阻塞错误处理catch或try/awaittry/catch适用场景服务器、并发请求、大文件脚本启动、小配置文件、一次性任务配合String.prototype.split()两种方式都能在数行代码内把文本文件转换为行数组。处理真实文件时请记得结合换行符规范化参考 normalize-line-endings.md与空行过滤就能在绝大多数场景下得到干净、可用的行数据。赞分享教程文档【免费下载链接】30-seconds-of-codeCoding articles to level up your development skills项目地址https://gitcode.com/gh_mirrors/30/30-seconds-of-code点击查看免费下载相关推荐30 seconds of code如何把 NodeList 转换为 JavaScript 数组30 seconds of code如何把 NodeList 转换为 JavaScript 数组 在浏览器端 JavaScript 开发中通过 Docume教程文档在 scikit-opt 里跑通第一个优化问题启发式算法实操在 scikit opt 里跑通第一个优化问题启发式算法实操 scikit opt 把遗传、粒子群、模拟退火、蚁群等 7 种启发式优化算法收进同一套接口你写教程文档30 seconds of codeJavaScript 异步函数组合pipeAsync 与 composeAsync实战指南30 seconds of codeJavaScript 异步函数组合pipeAsync 与 composeAsync实战指南 异步函数组合是函数式编程思教程文档创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考