迷一样的根目录
凌晨2点，程序员小李对着屏幕抓狂——他的插件在测试环境运行正常，但一到嵌套了5层的子目录就报错Cannot find module。他红着眼翻遍项目文件夹，反复核对../../../../的相对路径，却在层层目录中彻底迷失。"难道要写个递归往上爬？"他绝望地想着，突然在GitHub发现了pkg-dir这个仅30行代码的npm库...
痛点终结者：为什么需要自动定位根目录？
路径地狱
配置文件、资源引用依赖项目根目录，手写../容易出错
动态场景
脚手架、构建工具需兼容任意子目录启动的场景
传统方案
手动遍历父目录查找package.json，代码冗余且低效
pkg-dir的核心能力
核心逻辑
从当前目录向上递归，直到找到含package.json的目录
npm install pkg-dir # 1秒安装
// 无论当前文件在哪个子目录
import { packageDirectorySync } from 'pkg-dir';
console.log(packageDirectorySync()); // 直达项目根路径 ✅
双模式应对不同场景
| 异步版 | 同步版 |
|---|---|
await packageDirectory() | packageDirectorySync() |
| 适合ES模块等异步环境 | 脚本、工具类程序首选 |
高级用法
// 从指定目录开始搜索
packageDirectorySync({ cwd: '/Users/project/utils' })
真实应用场景
- 制作脚手架工具时自动识别调用位置的项目根目录
- 单元测试时无论
npm test从哪里启动，精准定位测试资源 - 开发Monorepo项目时在子包中快速定位主项目或兄弟包位置
性能天花板
- 10层嵌套目录查找仅需0.07ms
- 零依赖，源码仅相当于1/3篇高考作文的长度
"下次当你在目录迷宫中挣扎时，不妨记住这个原理简单却直击痛点的工具——它用极简的API印证了Unix哲学：
『只做一件事，并做到极致』。毕竟，真正优秀的轮子，从不需要重新发明。"
🔥 关注我的公众号「哈希茶馆」一起交流更多开发技巧
