在使用URLSearchParams设置含特殊字符（如$）的参数名时，浏览器默认会将其编码为%24；本文介绍如何在不破坏URL结构的前提下，安全地保留原始$字符。
在使用urlsearchparams设置含特殊字符（如`$`）的参数名时，浏览器默认会将其编码为`%24`；本文介绍如何在不破坏url结构的前提下，安全地保留原始`$`字符。
在现代Web开发中，URL和URLSearchParams API是构建动态URL的首选工具。然而，其设计遵循严格的URL编码规范（RFC 3986），将$等字符视为需百分号编码的“子分隔符”（sub-delimiter），因此调用params.toString()或访问url.search时，$param1总会变成 %24param1——即使该字符在HTTP协议中完全合法且被绝大多数服务器（如Node.js、Nginx、Spring Boot）原生支持。
关键认知：$ 是URL中允许未编码的合法字符
根据RFC 3986，$ 属于 sub-delims 字符集（与 !, ', (, ), *, +, ,, ;, = 同类），在URI的查询组件（query component） 中无需强制编码。浏览器的自动编码行为源于URLSearchParams的保守实现，并非协议要求。因此，解法不在于“阻止编码”，而在于“精准解码”——即在最终生成字符串后，仅对%24做定向还原。
✅ 推荐方案：toString().replace(/%24/g, '$')
这是最简洁、安全且兼容性最佳的做法：
const myUrl = new URL("http://www.example.com/");
myUrl.searchParams.set('$param1', '60');
myUrl.searchParams.set('$param2', '100');
// 关键一步：全局替换 %24 → $
const finalUrl = myUrl.toString().replace(/%24/g, '$');
console.log(finalUrl);
// 输出: http://www.example.com/?$param1=60&$param2=100⚠️ 注意事项：
- 仅替换 %24，不要使用 decodeURIComponent()：后者会错误解码其他合法编码（如空格%20→`、+`等），破坏参数值语义；
- 必须使用全局正则 /g：确保所有 $ 参数名均被还原（例如多个$前缀参数）；
- 务必在 toString() 之后执行：URLSearchParams 内部状态不可直接修改编码逻辑，字符串层面处理是唯一可控入口；
- 服务端需明确接受未编码 $：确认后端框架未强制校验或过滤查询键名中的$（主流框架默认允许）。
❌ 不推荐的替代方案
- encodeURI(params.toString())：重复编码，导致%2524（即%24被再次编码），彻底失效；
- 手动拼接字符串（如 "?$param1=60&$param2=100"）：放弃URLSearchParams的自动转义优势（如对&、=、空格等值的安全处理），极易引入注入漏洞；
- 使用 encodeURIComponent 单独处理键名再传入 .set()：URLSearchParams.set() 内部仍会二次编码，无效。
总结
当业务需要在URL参数名中显式使用$（例如对接GraphQL变量、特定API约定或内部路由规范）时，无需绕过标准API或引入第三方库。只需在调用 URL.toString() 后，通过轻量级正则替换完成语义对齐。该方案零依赖、无副作用、符合渐进增强原则，是平衡标准合规性与实际需求的最佳实践。
