---
title: "parseQuery"
description: "将 URL 查询字符串解析为键值对对象，支持多值参数和特殊字符的正确处理。"
seo_title: "parseQuery"
seo_description: "Parse a URL query string into a key-value object, grouping repeated keys into arrays so query data is easy to read and update."
canonical_url: "https://core.mhaibaraai.cn/docs/utilities/url/parse-query"
---
# parseQuery

> 将 URL 查询字符串解析为键值对对象，支持多值参数和特殊字符的正确处理。

## 用法

`parseQuery` 函数用于解析 URL 查询字符串为对象。

```ts
import { parseQuery } from '@movk/core'

parseQuery('?name=John&age=30')
// { name: 'John', age: '30' }

parseQuery('tags=a&tags=b&tags=c')
// { tags: ['a', 'b', 'c'] }

parseQuery('encoded=%E4%B8%AD%E6%96%87')
// { encoded: '中文' }
```

## API

### `parseQuery(search)`

解析 URL 查询字符串为对象。

### 参数

**search** (`string`) *required*: 查询字符串(可带或不带 ?)。

### 返回值

**返回值** (`Record<string, string | string[]>`): 解析后的查询参数对象。

## Changelog

See commit history for [src/utilities/url/query.ts](https://github.com/mhaibaraai/movk-core/commits/main/src/utilities/url/query.ts).


## Sitemap

See the full [sitemap](/sitemap.md) for all pages.