怎么在模板中生成带参数的URL_模板URL生成【操作】
URL 模板里怎么安全插值参数
直接拼接字符串是最常见的做法，但恰恰也是最容易踩坑的地方。举个例子，如果 user_id 碰巧是 123/abc，简单一拼就成了 /user/123/abc/profile，路由直接报404；又或者查询参数 q=hello world 里的空格没处理，要么变成 +，要么直接被截断，结果都不对。这里的关键在于：所有参数都必须经过 URI 编码，并且不能破坏 URL 原有的结构。
- 处理每个参数值时，请使用
encodeURIComponent()，而不是encodeURI()。后者不会编码/、?这类字符，不适合用于处理独立的参数值。 - 无论是路径中的动态段（比如
/users/{id}里的{id}），还是查询字符串（?name=xxx），都需要单独进行编码。切忌对整个 URL 字符串只调用一次编码函数。 - 如果模板里包含固定的路径斜杠（例如
/api/v1/posts/{post_id}），务必确保post_id这个值本身不包含斜杠等非法字符。一个更可控的做法是，在替换前先进行校验或抛出明确错误，这远比静默失败要好。
用 URLSearchParams 构建查询参数最省心
手动拼接 ?a=1&b=2 这样的字符串，很容易漏掉 &、多写 =，或者搞混 ? 和 & 的位置。浏览器原生的 URLSearchParams API 能自动处理编码和连接逻辑，兼容性也足够好（Chrome 49+/Firefox 29+），用起来省心不少。
- 创建时可以直接传入对象：
new URLSearchParams({ q: 'hello world', page: 2 })会自动生成q=hello%20world&page=2。 - 需要追加参数时用
.append()方法；如果想避免重复键，则使用.set()方法。 - 最终通过
.toString()方法获取编码后的参数字符串，直接拼接到 URL 后面即可，不需要自己手动添加?。 - 需要注意的是，这个 API 只负责处理
?后面的查询参数部分，不涉及路径的构建。
模板字符串 + 函数封装，避免每次重复写编码逻辑
当一个项目里需要处理的 URL 模板多起来之后，到处写 encodeURIComponent(x) 不仅繁琐，还容易遗漏。更好的办法是封装一个简单的工具函数，把模板字符串和参数对象一起传进去，让函数自动完成替换和编码。
- 可以定义一个这样的函数：
function urlTemplate(template, params) { return template.replace(/\{(\w+)\}/g, (_, key) => encodeURIComponent(params[key])); } - 调用示例：
urlTemplate('/user/{id}/posts', { id: '123/abc' })会返回/user/123%2Fabc/posts。 - 函数里使用正则表达式只匹配
{xxx}这种形式，避免误替换$xxx或:xxx等其他占位符，降低风险。 - 如果遇到参数缺失的情况，上述逻辑会把占位符替换成
undefined。建议增加一层检查，比如if (!(key in params)) throw new Error(...)，让问题尽早暴露。
后端渲染模板（如 Jinja2、EJS）里别信默认转义
前端 Ja vaScript 里编码逻辑由你掌控，但服务端模板引擎常常默认对变量进行 HTML 转义（比如把 & 转成 &）。结果就是，生成的 URL 里出现了 & 这样的字面量，浏览器会按字面解析，导致请求失败（如 400 错误）。
- 在 Jinja2 模板中，应该使用
{{ url|urlencode }}，而不是简单的{{ url }}。 - 在 EJS 模板中，使用
<%= encodeURIComponent(url) %>，不要用<%- url %>（后者仅取消 HTML 转义，并不进行 URI 编码）。 - 在 Node.js 的 Express 框架中，通过
res.render()传入模板的参数仍然是纯 Ja vaScript 对象，编码动作应该发生在模板层。不要在 Ja vaScript 层提前编码好再传进去，否则可能导致双重编码。
实际操作时，路径参数和查询参数的编码时机、范围、使用的工具都不同，混用同一套逻辑反而容易出错。只要牢牢盯住「谁负责编码哪一段」以及「编码结果是否会被模板引擎二次干扰」这两个关键点，基本上就能避开大多数麻烦。
