新闻详情

新闻详情

首页 / 资讯中心 / 详情

fs-extra `ensureFileSync` 完全指南:一行代码确保文件存在并自动补齐缺失目录

发布时间:2026/11/19 7:29:10来源:尧图网络
fs-extra `ensureFileSync` 完全指南:一行代码确保文件存在并自动补齐缺失目录
开发工具【免费下载链接】node-fs-extraNode.js: extra methods for the fs object like copy(), remove(), mkdirs()项目地址https://gitcode.com/gh_mirrors/no/node-fs-extra点击查看免费下载fs-extra为 Node.js 原生fs模块提供了大量便捷方法其中ensureFileSync()用于确保目标文件一定存在文件不存在则创建其所在目录若也不存在则一并递归创建文件已存在则原样保留、绝不改动内容。本文以 docs/ensureFile-sync.md 为骨架结合 lib/ensure/file.js 源码与 lib/ensure/tests/ensure.test.js、lib/ensure/tests/create.test.js 测试用例完整讲解该 API 的签名、底层原理、别名机制与实战用法读完即可在项目里安全、无脑地初始化文件。一、API 签名与核心语义ensureFileSync是同步方法签名与参数如下直接继承自官方文档ensureFileSync(file)fileString目标文件的绝对路径或相对路径别名createFileSync()——两个名字指向同一个实现可任意混用。核心行为三条铁律文件不存在→ 创建它文件所在的目录不存在→ 递归创建这些目录与mkdirsSync行为一致文件已存在→完全不修改不截断、不覆盖、不动内容也不更新时间戳。官方示例const fs require(fs-extra) const file /tmp/this/path/does/not/exist/file.txt fs.ensureFileSync(file) // file has now been created, including the directory it is to be placed in执行后/tmp/this/path/does/not/exist/这一整条目录链会被递归创建file.txt以空文件形式诞生。如果需要在异步场景中使用请参见配套文档 docs/ensureFile.md其同样支持回调Callback、Promise 与 async/await 三种写法。二、源码级实现ensureFileSync到底做了什么核心实现在 lib/ensure/file.js逻辑非常精巧可用如下流程概括function createFileSync (file) { // 1. 文件已存在且是普通文件 → 直接返回不碰内容 let stats try { stats fs.statSync(file) } catch { } if (stats stats.isFile()) return const dir path.dirname(file) // 2. 检查父目录 try { if (!fs.statSync(dir).isDirectory()) { // 父路径是文件而非目录 → 故意触发 ENOTDIR 错误 fs.readdirSync(dir) } } catch (err) { // 3. 父目录不存在ENOENT→ 递归创建整条目录链 if (err err.code ENOENT) mkdir.mkdirsSync(dir) else throw err } // 4. 创建空文件 fs.writeFileSync(file, ) }关键设计一已存在即短路返回第一步先用fs.statSync(file)探测目标一旦stats stats.isFile()成立便立即return。这意味着对已存在的文件调用是零副作用的不会改写内容、不会触发EACCES写入错误对软链接指向的普通文件statSync会跟随链接因此同样视为“已存在”而跳过。关键设计二父路径是文件时如何抛错如果file的父目录其实是一个文件例如路径为/tmp/a.txt/b.txt而/tmp/a.txt是文件statSync(dir).isDirectory()返回false此时代码刻意调用fs.readdirSync(dir)——注释写明“This is just to cause an internal ENOTDIR error to be thrown”即借readdirSync对“非目录路径”报ENOTDIR的底层行为向调用者抛出一个清晰、可捕获的错误码而不是糊里糊涂地失败。关键设计三父目录缺失时递归补齐当statSync(dir)抛出ENOENT时调用mkdir.mkdirsSync(dir)即mkdirsSync先创建整条目录链随后writeFileSync(file, )写入空文件。两步缺一不可只建目录不写文件、或只写文件不建目录都无法满足“ensure”语义。三、目录递归创建的底层依赖mkdirs家族ensureFileSync的目录能力完全复用mkdirs模块。在 lib/ensure/file.js 中它通过const mkdir require(../mkdirs)引入而 lib/mkdirs/index.js 将mkdirsSync指向make-dir.js中的makeDirSyncmodule.exports.makeDirSync (dir, options) { checkPath(dir) return fs.mkdirSync(dir, { mode: getMode(options), // 默认 0o777 recursive: true // 递归创建多级目录 }) }recursive: true是递归创建的关键等价于mkdir -p默认目录权限为0o777最终受进程umask约束可通过options.mode覆盖。因此ensureFileSync(/a/b/c.txt)等价于手写fs.mkdirSync(/a/b, { recursive: true })fs.writeFileSync(/a/b/c.txt, )但更简洁、更健壮。四、别名机制ensureFileSync与createFileSync是同一函数在 lib/ensure/index.js 中ensure 系列与 create 系列被显式绑定为同一引用const { createFile, createFileSync } require(./file) // ... createFileSync, ensureFile: createFile, ensureFileSync: createFileSync,也就是说fs.ensureFileSync fs.createFileSync同一函数对象fs.ensureFile fs.createFile异步版本同理。选择哪个名字纯粹是语义偏好ensure确保强调幂等保证create创建强调动作功能完全等价。该文件同时导出了ensureLinkSync/ensureSymlinkSync等兄弟方法构成完整的 ensure 家族。五、行为边界测试用例验证的三种场景仓库测试从三个维度锁定了该 API 的契约lib/ensure/tests/ensure.test.js场景预期行为测试断言文件不存在且目录链缺失递归创建目录并生成空文件assert(fs.existsSync(file))文件已存在内容为blah什么都不做内容原样保留assert(fs.existsSync(file))目标路径本身是一个目录抛错错误码为EISDIRassert.strictEqual(e.code, EISDIR)补充测试lib/ensure/tests/create.test.js还验证了内容不被修改先写入hello world再调用createFileSync读取结果仍是hello world目录树中某个节点是文件路径形如existingFile/xxx.txt时抛出ENOTDIR。这些测试共同回答了一个关键问题传入目录路径会得到EISDIR错误而非静默成功——ensureFileSync只保证“文件”的语义不负责“目录”的语义那属于 ensureDirSync。六、实战场景与组合用法ensureFileSync最常见的价值是消灭“先建目录再写文件”的样板代码。以下场景均可直接套用场景 1日志文件初始化const fs require(fs-extra) const logPath logs/2026/09/app.log fs.ensureFileSync(logPath) // logs/2026/09/ 自动创建 fs.appendFileSync(logPath, boot ok\n)场景 2配置文件占位const fs require(fs-extra) const path require(path) const configPath path.join(process.cwd(), config, local.json) fs.ensureFileSync(configPath) // 幂等多次启动不会破坏已有配置 const content fs.readFileSync(configPath, utf8) || {}场景 3与异步写文件配合const fs require(fs-extra) fs.ensureFileSync(/tmp/data/cache.json) // 同步补齐目录 fs.writeJson(/tmp/data/cache.json, { ok: true }) // 再异步写入内容七、注意事项同步阻塞ensureFileSync会阻塞事件循环仅适合启动初始化、配置准备等低频路径高频场景应使用 ensureFilePromise 版。创建的是空文件它只负责“文件存在”不写入任何内容默认内容为空字符串。目录权限递归创建的目录默认模式为0o777受umask影响如需自定义可在底层mkdirsSync传入{ mode }选项。路径校验底层checkPath见 lib/mkdirs/utils.js会校验路径有效性传入、null等非法路径会直接抛错。错误码语义目标为目录 →EISDIR路径中某节点是文件 →ENOTDIR无写权限 →EACCES。捕获后按错误码分流即可。八、小结ensureFileSync(file)是一个“幂等初始化”利器不存在就递归创建目录并生成空文件已存在则零改动返回。其实现由“先statSync短路”“借readdirSync抛ENOTDIR”“复用mkdirsSync递归建目录”“writeFileSync写空文件”四步构成配合 lib/ensure/tests/ensure.test.js 的契约测试行为边界非常清晰。在日志、缓存、配置等文件的启动初始化中它能把三五行 try/catch 压缩成一行调用且比手写fs.existsSync fs.mkdirSync fs.writeFileSync的组合更可靠。赞分享开发工具【免费下载链接】node-fs-extraNode.js: extra methods for the fs object like copy(), remove(), mkdirs()项目地址https://gitcode.com/gh_mirrors/no/node-fs-extra点击查看免费下载相关推荐node-fs-extra 的 ensureFile / createFile 深度指南幂等创建文件并自动补齐父目录node fs extra 的 ensureFile / createFile 深度指南幂等创建文件并自动补齐父目录 ensureFile file , ca开发工具node-fs-extra 的 emptyDirSync() 深度指南一步清空目录并保留目录本身node fs extra 的 emptyDirSync 深度指南一步清空目录并保留目录本身 导读 fs extra 是 Node.js 生态中广受欢迎的 f开发工具node-fs-extra 的 ensureLink / ensureLinkSync自动补全目录结构的硬链接创建指南node fs extra 的 ensureLink / ensureLinkSync自动补全目录结构的硬链接创建指南 ensureLink srcPath,开发工具创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/18 21:21:17

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/18 14:20:46

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/18 20:01:42

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/18 11:04:06

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/18 15:55:22

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/18 21:21:16

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉