# JavaScript 如何进行 URL 编码和解码

URL: https://caijiao.org/how-to/javascript/url-encode-decode
Source: docs/how-to/javascript/url-encode-decode.md
Description: JavaScript 如何进行 URL 编码和解码：单个参数用 encodeURIComponent，完整 URL 不要整段乱编码。 示例可直接复制到浏览器或项目代码中，并附相关教程、工具入口。

## 快速答案

单个参数用 encodeURIComponent，完整 URL 不要整段乱编码。

```js
const q = encodeURIComponent('json 工具');
const text = decodeURIComponent(q);
```

## 使用要点

- 确认代码运行在浏览器环境；如果服务端渲染会执行同一段代码，要把读取逻辑放到客户端生命周期里。
- 处理 URL、Cookie 或存储值时，先约定编码、过期时间和缺省值。

## 相关内容

- [JavaScript / TypeScript 问题](/how-to/javascript/)
- [JavaScript 教程](/javascript/)
- [TypeScript 教程](/ts/)
- [JSON Formatter](/tool/json-formatter)
- [JSON Validator](/tool/json-validator)