ENOENT报错根本原因是./file.txt中的./指向终端当前工作目录（process.cwd()），而非JS文件所在目录；正确做法是用path.join(__dirname, 'file.txt')锚定文件位置，实现跨平台路径安全。
为什么 fs.readFile('./file.txt') 在 VSCode 终端里总报 ENOENT？
不是 VSCode 的问题，是 Node.js 本身的行为：路径里的 ./ 指的是终端当前工作目录（process.cwd()），而不是你正在运行的 JS 文件所在目录。你在资源管理器里右键「在终端中打开」，或者用 cd 切到别的目录再运行 node app.js，./file.txt 就会去那个目录下找 —— 跟 app.js 放哪儿完全无关。
常见错误现象：
- 在文件所在目录执行
node index.js成功，换到父目录执行就报Error: ENOENT: no such file or directory, open './config.json' - VSCode 自带终端默认打开位置是工作区根目录，但你的 JS 文件在
src/下，./data.csv实际去找的是./data.csv（工作区根），不是src/data.csv
用 __dirname + path.join() 构建稳定路径
这才是 Node.js 官方推荐、跨平台安全的做法。它把路径锚定在当前 JS 文件位置，跟启动位置彻底解耦。
实操建议：
- 别手动拼字符串（比如
__dirname + '/data.txt'），Windows 和 Linux 的路径分隔符不同，容易出错 - 必须引入
path模块：const path = require('path'); - 用
path.join(__dirname, 'data.txt')——join会自动处理斜杠方向、去重、规范化 - 如果要读子目录下的文件，写成
path.join(__dirname, 'assets', 'logo.png')，不用管中间是/还是\
示例：
const fs = require('fs');
const path = require('path');
// ✅ 正确：从当前 JS 文件出发找同级的 config.json
const configPath = path.join(__dirname, 'config.json');
fs.readFile(configPath, 'utf8', (err, data) => {
if (err) throw err;
console.log(data);
});
// ✅ 正确：找上层目录的 .env 文件
const envPath = path.join(__dirname, '..', '.env');
VSCode 终端里路径混乱？先确认 process.cwd() 是啥
有时候你以为自己在对的目录，其实终端启动位置不对。加一行调试代码就能立刻看清：
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
console.log('当前工作目录:', process.cwd());
console.log('当前文件目录:', __dirname);
对比这两个输出，就能判断你写的 ./xxx 到底想去哪找。VSCode 终端默认打开位置取决于你「右键打开终端」的位置 —— 是点击文件、文件夹，还是空白处，结果都不同。
避免踩坑：
- 不要依赖「看起来目录是对的」，每次不确定就打印
process.cwd() - VSCode 设置里没有全局统一终端启动路径，每个终端实例独立；想固定，得手动
cd或配置任务（tasks.json） - 调试时（F5），
launch.json里的cwd字段才真正决定工作目录，跟终端无关
绝对路径硬编码？千万别直接写 C:\xxx 或 /home/user/xxx
这种写法在本地可能跑通，但一换机器、一部署就炸。尤其团队协作或 CI 环境，路径结构根本不可控。
替代方案：
- 所有路径都基于
__dirname或项目根（可用path.resolve(__dirname, '..')往上找） - 环境变量控制关键路径（比如
process.env.DATA_DIR），配合.env文件加载 - VSCode 里需要粘贴绝对路径时（比如调试配置），用右键「复制路径」功能，但只用于配置，不写进业务代码
注意：__dirname 和 __filename 是 Node.js 模块作用域内自动注入的变量，不是全局的，所以不能在非模块上下文（比如直接 node -e "console.log(__dirname)"）里用。
最常被忽略的一点：路径逻辑一旦脱离 __dirname，就等于放弃了可移植性。哪怕只是临时测试，也建议第一行就写好 path.join(__dirname, ...) —— 后续迁移成本几乎为零，而修复路径 bug 的时间远不止一分钟。
