在使用 URLSearchParams 设置含 $ 等特殊字符的参数名时，浏览器默认将其编码为 %24；本文详解如何安全、合规地保留在 URL 中的原始 $ 符号，避免手动编码干扰，并提供可直接复用的解决方案。
在使用 `urlsearchparams` 设置含 `$` 等特殊字符的参数名时，浏览器默认将其编码为 `%24`；本文详解如何安全、合规地保留在 url 中的原始 `$` 符号，避免手动编码干扰，并提供可直接复用的解决方案。
在现代 Web 开发中，URL 和 URLSearchParams API 是构建动态查询字符串的首选方式。然而，一个常见误区是认为“特殊字符必须手动编码才能安全传输”，而实际上，$ 是 RFC 3986 定义的 URL 子分隔符（sub-delimiter），在参数名和值中本就允许不编码。但 URLSearchParams 实现（包括 Chrome、Firefox、Safari）出于统一转义策略，默认将 $ 编码为 %24 —— 这并非错误，而是规范兼容性设计。
关键在于：不应在 toString() 前对参数名做 encodeURI 或 encodeURIComponent 处理，因为 URLSearchParams 内部已执行标准化编码；若强行预编码，会导致双重编码（如 $ → %24 → %2524），更不可取。
✅ 正确做法是：利用 URL 对象天然支持 $ 的特性，直接操作 searchParams，最后通过字符串替换还原 $：
const myUrl = new URL("http://www.example.com/");
// 直接设置含 $ 的参数名（无需预编码）
myUrl.searchParams.set('$param1', '60');
myUrl.searchParams.set('$param2', '100');
// 生成最终 URL 字符串，并安全还原 $ 符号
const finalUrl = myUrl.toString().replace(/%24/g, '$');
console.log(finalUrl);
// 输出：http://www.example.com/?$param1=60&$param2=100⚠️ 注意事项：
- 替换应使用全局正则 /g，避免仅替换首个 %24；
- 仅当服务端明确支持未编码的 $ 作为参数名前缀时才推荐此方案（绝大多数主流后端框架如 Express、Spring Boot、Django 均能正确解析）；
- 避免对其他需严格编码的字符（如空格、#、?、&）采用相同策略——$ 是特例，非通用规则；
- 若需更高可移植性或服务端限制严格，建议改用语义化参数名（如 dollar_param1），而非依赖符号保留。
? 总结：$ 在 URL 参数名中本属合法字符，URLSearchParams 的编码行为是保守实现。通过 toString() 后精准替换 %24 为 $，是在不破坏 URL 结构、不引入额外依赖前提下的简洁、可靠解法。该方案已在生产环境广泛验证，兼顾标准兼容性与实际需求。
