Path.normalize 是 Node.js path 模块的纯字符串路径规范化方法,解析 .. 和 .、统一斜杠、清理空段,不访问文件系统;对相对路径不补根,超界 .. 保留;需配合 resolve 获取绝对路径。

Path.normalize 是 Node.js 中 path 模块提供的一个实用方法,用于将路径字符串中的冗余部分(如 ..、.、重复斜杠、空段)清理并转换为标准、可预测的格式。它不访问文件系统,只做纯字符串规范化处理。
处理上级目录和当前目录符号
该方法会解析并“执行”路径中的 ..(返回上一级)和 .(当前目录),逐段抵消,直到无法再简化为止。例如:
-
path.normalize('a/b/../c')→'a/c' -
path.normalize('a/./b')→'a/b' -
path.normalize('a/b/../../c')→'c'(从a出发,两次..跳出到根,再进入c)
统一斜杠与清理空白段
在 Windows 上,它会把所有反斜杠 和正斜杠 / 统一为系统默认分隔符(path.sep);在 POSIX 系统(Linux/macOS)则统一为 /。同时自动合并多个连续斜杠或空段(如 //、/a//b/)为单个分隔符:
-
path.normalize('/a//b////c')→'/a/b/c' -
path.normalize('a\b\..\c')(Windows)→'a\c'
注意相对路径的起点逻辑
Path.normalize 不会自动补全或解析绝对路径前缀。如果输入是相对路径(无根),结果仍是相对的;若开头有 .. 超出当前层级,它不会报错,而是保留多余的部分(表示“向上超出当前范围”):
-
path.normalize('../a')→'../a' -
path.normalize('../../a/b')→'../../a/b' - 这种输出是合法且有意为之的——便于后续拼接或配合
path.resolve使用
结合 resolve 更安全地处理路径变量
如果目标是获得一个真实、可访问的绝对路径(尤其涉及用户输入或配置路径变量时),仅用 normalize 不够。应优先考虑 path.resolve(),它以当前工作目录为基准,隐式调用 normalize 并确保结果为绝对路径:
-
path.normalize('../a')→'../a'(仍为相对) -
path.resolve('../a')→'/Users/you/project/../a'(实际是绝对路径,已 normalize) - 对路径变量做校验时,建议先
normalize再判断是否包含非法段(如以..开头且不可信),必要时用resolve+relative做白名单限制










