Node.js中URL解析后重复编码问题：正确处理方式咨询

场景还原 #

原始URL包含空格：

const u = 'http://examples.com/hello world/test';

通过Node.js内置URL对象解析时，会自动对空格进行URL编码：

const uObj = new URL(u);
// 输出的URL对象结构：
// URL {
//   href: 'http://examples.com/hello%20world/test',
//   origin: 'http://examples.com',
//   pathname: '/hello%20world/test',
//   ...其他属性
// }

调用uObj.toString()得到编码后的字符串：

uObj.toString();
// 返回：http://examples.com/hello%20world/test

若将该字符串传入会自动编码的第三方库/函数，会导致%被二次编码为%25，生成错误URL：

http://examples.com/hello%2520world/test

问题解答 #

1. 能否直接使用decodeURI(uObj.toString())？

完全可以。
decodeURI()遵循RFC 3986规范，会准确将URL对象编码后的字符（比如%20）还原为原始字符，同时不会破坏URL的结构（比如保留http://、/等必要分隔符）。执行后能直接得到带空格的原始URL：

decodeURI(uObj.toString());
// 返回：http://examples.com/hello world/test

2. 特殊场景的处理

如果URL包含查询参数，且你希望仅解码路径部分、保留查询参数的编码状态，可以单独处理pathname：

const decodedPath = decodeURI(uObj.pathname);
const originalUrl = `${uObj.origin}${decodedPath}${uObj.search}${uObj.hash}`;

3. 是否需要借助npm包？

绝大多数日常场景不需要。内置的decodeURI()足够处理标准URL的编码还原需求。只有当你遇到复杂边缘场景（比如非标准编码、严格匹配最新RFC规范的特殊字符处理）时，才需要考虑使用专门的URL处理包。

内容的提问来源于stack exchange，提问作者xaxa