q搜索 / q过滤解释（q参数、query参数、q=）

新增普通表单的手动岗位新建/编辑/删除（PRD §3.1 路径 0），并接入新的 q 搜索参数

q搜索q过滤是什么？

文章目录

["q 搜索" / "q 过滤" 解释](#"q 搜索" / "q 过滤" 解释)
- [什么是 `q` 参数？](#什么是 q 参数？)
- [q 搜索 vs q 过滤](#q 搜索 vs q 过滤)
- 在你提到的需求中的含义
- [常见的 `q` 参数用法示例](#常见的 q 参数用法示例)
- [为什么用 `q` 而不是 `search` 或 `keyword`？](#为什么用 q 而不是 search 或 keyword？)

"q 搜索" / "q 过滤" 解释

什么是 `q` 参数？

在 Web 开发和 API 设计中，q 是 "query"（查询） 的缩写，是业界约定俗成的通用搜索参数名。

它通常以 URL 查询参数的形式出现：

复制代码

GET /api/positions?q=前端工程师
GET /api/forms?q=请假

q 搜索 vs q 过滤

概念	含义	典型场景
q 搜索	用 `q` 参数做全文/模糊搜索，在多个字段中匹配关键词	搜索框输入关键词，跨名称、描述、编号等字段查找
q 过滤	用 `q` 参数对已有列表做筛选过滤，缩小展示范围	在列表页顶部输入文字，实时过滤掉不匹配的条目

两者本质很接近，核心思路都是：一个统一的文本输入框 → 一个 q 参数 → 后端/前端根据该参数返回匹配结果。

在你提到的需求中的含义

新增普通表单的手动岗位新建/编辑/删除（PRD §3.1 路径 0），并接入新的 q 搜索参数

这句话的意思是：

新增功能：为普通表单增加手动岗位的 CRUD（新建 / 编辑 / 删除）操作
接入 q 搜索 ：在岗位列表中加入一个搜索框，将用户输入的关键词作为 q 参数传给后端（或用于前端过滤），从而实现对岗位列表的搜索/过滤功能

常见的 `q` 参数用法示例

javascript 复制代码

// 前端发起请求
fetch(`/api/positions?q=${encodeURIComponent(keyword)}`)

// 后端接收并处理
const keyword = req.query.q;
const results = await Position.find({
  $or: [
    { name: { $regex: keyword, $options: 'i' } },
    { description: { $regex: keyword, $options: 'i' } }
  ]
});

为什么用 `q` 而不是 `search` 或 `keyword`？

这是源自 Google、GitHub、Stack Overflow 等大型产品的惯例，q 短小、通用、语义明确，已成为 REST API 和 Web 应用中搜索参数的事实标准。

简单总结 ：q 就是搜索关键词的参数名，"接入新的 q 搜索参数"就是在岗位列表里加一个搜索框，让用户能按关键词搜索岗位。