jquery获取url参数怎么写?手动解析比插件稳
- 2026年11月14日
- 46 次
页面上要读 ?id=3 这种参数,非得引一个 query 插件吗?答案取决于两件事:参数里有没有同名键和中文,以及还要不要兼容 IE11。这两条只要占住一条,各家的行为就开始不一样,jquery获取url参数这件事也就没有统一答案。边界先摆清楚,后面才好判断。
结论:十几行代码,自己切
答案是不用插件。取 location.search、去掉前导问号、按 & 切开、再按第一个 = 分成键和值,逐个值解码。每一步都能单独打日志,出错时能定位到具体哪一环。
function getQuery(name) {
var raw = location.search.slice(1);
if (!raw) return '';
var pairs = raw.split('&');
for (var i = 0; i < pairs.length; i++) {
var at = pairs[i].indexOf('=');
if (at < 0) continue;
if (pairs[i].slice(0, at) !== name) continue;
var val = pairs[i].slice(at + 1);
try {
return decodeURIComponent(val);
} catch (e) {
return val;
}
}
return '';
}
拿 ?kw=%E4%B8%AD%E6%96%87&page=2 去调,getQuery('kw') 返回「中文」,getQuery('page') 返回字符串 "2"。前者说明解码只发生了一次,后者提醒你别拿返回值直接做加法。

location.search 有个细节值得先记:它取的是地址栏里问号后面那一串,还把问号一起带回来;没有查询串时是空字符串。slice(1) 之前那句判空就是这么来的。第一次写漏了,页面没参数时 split('&') 得到 [''],循环照跑,返回空串,看着像参数不存在,其实一次判断都没进。
键名本身也可能被编码,比如 %E5%85%B3%E9%94%AE=1 这样一对,键是三个百分号转义,直接拿中文去比同样匹配不上。要么先解键再比,要么在发参数的一侧就约定只用 ASCII 键名。
用jquery获取url参数时,真正决定结果的是切和解的先后,不是函数叫什么名字。
为什么说手动解析查询字符串更稳
插件通常干两件事:拿一个正则把整串切成键值对,或者把 $.param 的序列化规则反着推一遍。简单参数上两种做法都没问题,一旦遇到同名键、数组形式的键、编码不统一,行为就不由你控制了。
解码次数也常被插件吃掉。URLSearchParams 在解析时只解一次,而某些插件先把整串解一遍、再逐值解一遍,同一个值就解了两次。值里本来存着 %25E4%25B8%25AD 这种内容时,正确的输出是 %E4%B8%AD;再解一次就变成「中」,把一段字面量当成了待解码内容,属于过度解码。
jQuery 核心库只提供 $.param 这个方向,对象转字符串,没有反向解析。所谓取参插件,是第三方按自己的假设补出来的,假设不同,结果就不同。

自己切的好处是中间状态可见:切完的数组、没解码的原始值、解码后的结果,都能打印出来对照。
还有一个顺序问题。先解码再按 & 切分是错的:值里如果有一个 %26,解码后变成 &,一对参数会被切成两对。正确顺序是先用原始串切,再对每个值单独解码。
中文参数的解码,和那个加号
中文是最容易出错的一步。decodeURIComponent 不是「解不开就原样返回」,遇到孤立的百分号会抛错。在 node 里跑 decodeURIComponent('100%'),输出是 URIError: URI malformed,整行带着堆栈。
所以解码要包在 try/catch 里,失败就把原始值留着交给下游。一次搜索词带 % 的请求里,后端把用户的「100%」直接拼进 URL 没有编码,前端解的时候脚本停住,控制台第一行就是这句 URI malformed。
加号是另一回事。URLSearchParams 把 + 当空格,decodeURIComponent 不认 +。同一串 q=a+b,前者给出 "a b",后者给出 "a+b"。
node -e "console.log(new URLSearchParams('q=a+b').get('q'))"
node -e "console.log(decodeURIComponent('a+b'))"
第一条打印 a b,中间一个空格;第二条打印 a+b,加号原样留着。PHP 的 $_GET 走前一种规则,手动解出来的值直接拿去和后端比对,会差一个字符。
两边规则不一致时,以谁为准得提前定。接口由 PHP 写就按加号当空格处理,接口用 node 的 URLSearchParams 就保留加号。定不下来,就先把值统一 encodeURIComponent 再发出去。
数组参数:a[]=1&a[]=2 和 a=1&a=2 不是一回事
后端按 PHP 的习惯拼参数时,jquery获取url参数还会碰到 a[]=1&a[]=2 这种键名。jQuery 的 $.param({a:[1,2]}) 生成的是 a%5B%5D=1&a%5B%5D=2,解码回来正是带方括号的形式。

手动按 = 切开,键是字符串 "a[]",拿 'a' 去比对永远匹配不上,函数返回空。代码不报错,只是拿不到值,这类静默失败最难查,也最容易被插件掩盖。
换成 a=1&a=2,手动循环如果每次命中就 return,只拿到第一个 1;写成覆盖赋值,留下的是最后一个 2。上面那个 getQuery 就是命中即返回的写法,想留最后一个,把 return 换成赋值、循环走完再返回。两种写法都不算错,错在你没意识到自己选了哪一种。
URLSearchParams 对这两种键名的处理更明确:get 给第一个值,getAll 给全部。
var qs = new URLSearchParams('a=1&a=2');
qs.get('a'); // '1',第一个
qs.getAll('a'); // ['1', '2']
var qs2 = new URLSearchParams('a[]=1&a[]=2');
qs2.get('a'); // null,键名其实是 a[]
qs2.getAll('a[]'); // ['1', '2']
注释里的返回值来自 node 的实际输出,浏览器控制台结果一致。手动循环最容易和它差开的一点就是:覆盖赋值留最后一个,get 给第一个。
这些情形,别自己切
参数是嵌套结构时,比如 a[b][c]=1,手写的两层循环会变成一个半成品解析器。
要解的不是 location.search 而是整条 URL,或者查询串藏在 hash 后面,取哪一段得先想清楚。项目里已经统一引入 polyfill、或者框架自带路由参数解析的,跟着那套走,同一个工程并存两套取参逻辑,比用错一套更难查。
只取一个 ASCII 参数、又不用兼容老浏览器时,jquery获取url参数一行就够:new URLSearchParams(location.search).get('id'),另写函数属于多余。
必须支持 IE11 这类没有 URLSearchParams 的环境时,没有原生兜底,就退回手动切分。上面那个函数留着别删。
若非作者标注皆为李涛自留地原创文章,转载或复制请以超链接形式并注明出处。
- jQuery实现网站导航跟随链接选中样式 2021-02-04
- jquery each和for循环怎么选?要中断就用for 2026-11-11
- jquery常见交互动效失效?从引入到事件绑定的排查顺序 2026-11-22
- PHP array_merge_recursive() 和 array_replace() 详解:数组合并与替换 2026-07-02
- flex布局的适用范围到底有多大,我拿三个页面做了对比 2026-11-08
- 网站打开慢是什么原因造成的?按耗时查5个环节 2026-11-12
