用途:将 JS/CommonJS 项目的入口文件及其静态 require() 依赖完整复制到 project-backup 目录,形成项目快照,适合重构前留存原版本或按要求“备份代码/创建快照”。
主要能力:优先读取 package.json 的 main 字段,其次检测 main.js、index.js、app.js 作为入口;通过 -d 指定项目根,或从当前目录向上查找 package.json;用 BFS 递归检测多层嵌套依赖(最大深度 10 层),可处理 A→B→A 循环依赖;只匹配相对路径 require("./xxx")、require("../xxx") 及带 .js 的裸文件名,自动过滤 require("fs")、require("lodash") 等 npm 包;依赖文件在备份目录中保留原始相对路径结构;扫描现有备份文件夹前缀数字取最大值加一,两位数补零后与用户提供的名称拼接,如 09第一次重构。
使用方式:要求 Node.js 14.x 或更高版本,脚本为 backup.mjs。命令示例: node backup.mjs "备份名称" node backup.mjs "备份名称" -d <项目根目录> node backup.mjs "备份名称" -e <入口文件> node backup.mjs # 纯编号备份 执行时建议通过 -d 指定项目根绝对路径,完成后列出 project-backup/<备份名称>/ 目录确认结果。
限制:仅支持静态 require() 语法,使用动态 require 或 ESM import 时可能遗漏依赖文件;入口文件未找到通常因项目根不正确,需用 -d 明确指定;若备份目录已存在同名备份,文件会被覆盖;文件被编辑器锁定时复制可能失败,需关闭相关文件。资料未提供其他平台支持、性能指标或收费信息。