必须对URL中非ASCII字符和保留字符(如空格、中文、#、?、&等)在路径和查询参数中手动encodeURIComponent编码;仅编码动态值部分,不可整URL编码;a标签应配合data-url或URL构造器安全跳转。

HTML5 中用 location.href 或 <a href></a> 跳转含特殊符号(如空格、中文、#、?、&)的 URL 时,浏览器会解析失败或截断地址——必须手动转义,不能靠浏览器自动处理。
哪些字符必须 encodeURIComponent 处理
URL 中非 ASCII 字符和保留字符(! * ' ( ) ; : @ & = + $ , / ? # [ ])在路径、查询参数里都需编码。常见踩坑点:
-
空格不是变成+(那是application/x-www-form-urlencoded的规则),而是%20 -
中文如测试必须转成%E6%B5%8B%E8%AF%95,否则跳转后变成乱码或 404 -
https://site.com/search?q=hello world&tag=前端中的和前端都要单独编码,不能只包整个字符串 -
location.href = url前若漏了encodeURIComponent,控制台可能无报错,但服务端收不到完整参数
location.href 跳转时的正确转义写法
只对「动态拼接的部分」做 encodeURIComponent,不要整条 URL 都包——否则 http:// 里的 :、/ 也会被误编码,导致协议失效。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 错误:
location.href = encodeURIComponent('https://a.com/path?k=中文') - 正确:只编码值部分:
location.href = 'https://a.com/path?k=' + encodeURIComponent('中文') - 多参数示例:
const q = 'hello world'; const tag = '前端'; location.href = `/search?q=${encodeURIComponent(q)}&tag=${encodeURIComponent(tag)}` - 如果路径本身含变量(比如用户输入的文件名),也要单独编码:
`/download/${encodeURIComponent(filename)}`
a 标签 href 属性无法运行 JS 怎么办
<a href="javascript:..."></a> 已被现代浏览器限制,且无法对动态内容做转义;改用事件绑定更可靠:
立即学习“前端免费学习笔记(深入)”;
- HTML 中只放干净的
href="#",加data-url存原始地址:<a href="#" data-url="/go?name=张三&city=上海" onclick="jump(this)">点击</a> - JS 里处理:
function jump(el) { const url = el.dataset.url; const encoded = url.replace(/(?:\?|&)([^=]+)=([^&]*)/g, (m, k, v) => `${k}=${encodeURIComponent(v)}`); location.href = encoded; } - 更稳妥的做法是直接用
URL构造器:const u = new URL('/go', location.origin); u.searchParams.set('name', '张三'); u.searchParams.set('city', '上海'); location.href = u.toString();
最易忽略的是路径段(path segment)和查询参数(query param)的编码边界——/user/张三 里的 张三 要用 encodeURIComponent,但 /user/ 本身不能动;URL 构造器虽能自动处理 query,但对 path 仍需手动编码,否则斜杠或点号可能破坏路由结构。


















