本文介绍在 url 包含多个同名查询参数（如 `foo=1&foo=4`）时，如何仅删除其中特定值（如 `foo=4`）的参数项，而非清空所有同名参数，避免 `urlsearchparams.delete(key, value)` 的误用陷阱。

URLSearchParams.delete(key, value) 方法在规范中并不支持按值精确匹配删除单个条目——它实际忽略第二个参数（value），等价于 delete(key)，即删除该 key 的所有实例。因此，原代码中 url.searchParams.delete("foo", 4) 实际会移除全部 foo 参数（foo=1 和 foo=4），与预期不符。

要实现「仅删 foo=4，保留 foo=1」，需手动定位并移除目标键值对。核心思路是：将所有同名参数转为数组 → 找到目标值的索引 → 构造新参数集合，跳过该位置。

以下是安全、标准、可复用的解决方案：

function deleteParamWithValue(urlObj, key, valueToRemove) {
  const params = new URLSearchParams(urlObj.search);
  const allValues = params.getAll(key);

  // 查找第一个匹配值的索引
  const index = allValues.indexOf(valueToRemove);
  if (index === -1) return; // 值不存在，无需操作

  // 构建新参数：保留其他 key，对目标 key 仅保留非匹配值
  const newParams = new URLSearchParams();
  for (const [k, v] of params) {
    if (k !== key) {
      newParams.append(k, v);
    } else if (v !== valueToRemove || !newParams.has(key)) {
      // 关键逻辑：对目标 key，只添加「第一次出现的非匹配值」或「所有非匹配值」
      // 更稳妥的做法是重建整个 key 的值列表（见下方优化版）
    }
  }

  // ✅ 推荐做法：完全重建目标 key 的值（清晰、可靠）
  for (const [k, v] of params) {
    if (k !== key) {
      newParams.append(k, v);
    }
  }
  // 单独追加过滤后的目标 key 值
  allValues.filter(val => val !== valueToRemove).forEach(val => {
    newParams.append(key, val);
  });

  urlObj.search = newParams.toString();
}

// 使用示例
const url = new URL("https://example.com?foo=1&bar=2");
url.searchParams.append("foo", "4"); // → foo=1&foo=4&bar=2
console.log(url.search); // ?foo=1&foo=4&bar=2

deleteParamWithValue(url, "foo", "4");
console.log(url.search); // ?foo=1&bar=2 ✅

⚠️ 注意事项：

• URLSearchParams.getAll() 返回的是当前所有值的快照数组，直接修改该数组（如 splice()）不会影响原始 URLSearchParams 对象——这是常见误区。原答案中的 params.getAll("foo").splice(...) 并不生效。
• 正确方式是重建参数：先提取全部键值对，再对目标 key 过滤后重新 append。
• 若需删除「第 N 个出现的同名参数」（而非按值），可用 entries() 遍历并计数，但按值删除更常见且语义明确。

总结：URLSearchParams 不提供原生的“按键+值精准删除单条”方法。务必通过 getAll() + 过滤 + 重建的方式实现精准控制，确保 URL 查询参数的变更符合业务预期。