# PR #48549 完整报告

- 仓库：`vllm-project/vllm`
- 标题：[Misc] Clean up "swap_space"
- 合并时间：2026-07-14 12:43
- 原文链接：http://prhub.com.cn/vllm-project/vllm/pull/48549

---

# 执行摘要

- 一句话：清除废弃参数 swap_space 的兼容代码
- 推荐动作：该 PR 属于常规维护清理，值得快速合并。无需特别审查或测试。

# 功能与动机

PR 描述指出 `swap_space` 自 v0.18.0 起已废弃，现在可以安全地清理该警告，以消除遗留的兼容代码。

# 实现拆解

仅涉及一个文件 `vllm/entrypoints/llm.py`，删除了 `LLM.__init__` 方法中检查 `kwargs` 是否包含 `swap_space` 并弹出它、同时发出 `DeprecationWarning` 的代码块（共 11 行）。本次变更为纯删除，无新增代码。

关键文件：
- `vllm/entrypoints/llm.py`（模块 入口；类别 source；类型 dependency-wiring）: 唯一变更文件，移除了 swap_space 参数的废弃兼容逻辑。

关键符号：未识别

## 关键源码片段

### `vllm/entrypoints/llm.py`

唯一变更文件，移除了 swap_space 参数的废弃兼容逻辑。

```python
# vllm/entrypoints/llm.py ( 变更后 )
def __init__(
    self,
    ...
    **kwargs: Any,
) -> None:
    """LLM constructor."""

    # 注意：swap_space 参数兼容代码已删除（自 v0.18.0 起废弃）

    if "disable_log_stats" not in kwargs:
        kwargs["disable_log_stats"] = True

    if "worker_cls" in kwargs:
        worker_cls = kwargs["worker_cls"]
        if isinstance(worker_cls, type):
            kwargs["worker_cls"] = cloudpickle.dumps(worker_cls)

    if "kv_transfer_config" in kwargs and isinstance(
        kwargs["kv_transfer_config"], dict
    ):
        from vllm.config.kv_transfer import KVTransferConfig
        raw_config_dict = kwargs["kv_transfer_config"]
        try:
            kwargs["kv_transfer_config"] = KVTransferConfig(**raw_config_dict)
        except ValidationError as e:
            logger.error(...)
            raise ValueError(...)

    if hf_overrides is None:
        hf_overrides = {}

```

# 评论区精华

无讨论。

- 暂无高价值评论线程

# 风险与影响

- 风险：风险极低。删除的是已长期废弃参数的兼容处理，即使仍有用户传入 `swap_space`，该参数会被 `**kwargs` 接收并传入底层配置，但底层已不再使用，因此不会引发错误或行为改变。
- 影响：影响范围极小，仅涉及 Python 同步调用接口的构造函数，不涉及异步接口或服务端。用户若仍使用该参数，将不再收到弃用警告，但参数本身仍会被静默忽略。
- 风险标记：暂无

# 关联脉络

- 暂无明显关联 PR