跨平台路径处理必须使用 Node.js 的 path 模块：path.join() 替代字符串拼接，path.normalize() 规范输入路径，path.resolve() 获取绝对路径，必要时用 replace() 统一为正斜杠。
直接用字符串拼接路径（比如 './src/' + filename）是跨平台路径 bug 的主要来源。node.js 的 path 模块不是可选项，而是必须项——它让代码在 windows、linux 和 macos 上用同一套逻辑输出各自合规的路径。
用 path.join() 替代字符串拼接
这是最常用也最有效的做法。它自动选用当前系统的分隔符，并清理冗余符号（如多余的 / 或 ..）。
-
❌ 错误写法：
const p = './config/' + 'db.json';—— 在 Windows 上生成./config/db.json，系统虽可能容忍，但不规范，且遇到特殊字符或用户输入时易出错 -
✅ 正确写法：
const p = path.join('.', 'config', 'db.json');—— Windows 输出.configdb.json，macOS/Linux 输出./config/db.json - 所有参数必须是字符串；传入
undefined或数字会抛错，建议提前校验或使用默认值
用 path.normalize() 统一路径格式
当你从外部接收路径（如命令行参数、配置文件、用户上传字段），里面可能混有 ../、重复斜杠或错误分隔符。此时 normalize() 能把它转成标准形式。
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 例如：
path.normalize('C:\Users\..\AppData\local//cache')→C:AppDatalocalcache（Windows） - 再如：
path.normalize('/home/user/./docs/../notes')→/home/user/notes（Linux/macOS） - 注意：它不会把路径变成绝对路径，也不检查文件是否存在，只做格式规整
对特定工具（如 chokidar）做斜杠统一处理
有些第三方库（如 chokidar、glob）内部依赖 POSIX 风格的正斜杠 /，即使在 Windows 上也要求传入 /。这时不能只靠 join 或 normalize。
- 先用
path.join()构建路径，再用.replace(/\/g, '/')强制转为正斜杠 - 示例：
chokidar.watch(path.join(__dirname, 'src').replace(/\/g, '/')) - 监听回调中返回的变更路径，在 Windows 下仍是反斜杠，需按需再次转换，不要假设格式一致
需要绝对路径时，优先用 path.resolve()
resolve() 不仅拼接，还会从右往左解析相对段（..、.），并以当前工作目录或指定根目录为起点，输出一个真正的绝对路径。
-
path.resolve('src', '..', 'config', 'index.js')→/full/path/to/config/index.js（无论在哪执行） - 比
path.join(__dirname, ...)更可靠，尤其在软链接或进程 cwd 变更的场景下 - 适合构建配置加载、模块查找、日志写入等需确定物理位置的操作
