Pylance报Key/value pairs are not allowed within a set错误求解

Pylance抛出Key/value pairs are not allowed within a set是语法层面的类型检测提示：Python中大括号{}默认有两种语义——包裹键值对时是字典（dict），包裹普通元素时是集合（set），如果一段被Pylance判定为集合定义的大括号内部出现了key: value格式的键值对，就会触发该报错。
调用pd.concat（注意官方接口名是concat，不存在concate的拼写）时触发这个错误，本质都是传参语法写错，导致参数位置的内容被解析器误判为集合字面量。

• 先修正函数名拼写：确认调用的是pandas.concat，拼写错误会导致Pylance丢失接口类型定义，触发连锁的参数判定错误。
• 顺着报错行号找最近的未闭合大括号：这个报错永远对应某一处大括号包裹的内容，定位到括号范围后再核对内部语法即可。
• 核对concat的传参规则：该接口第一个位置参数objs仅接受列表、元组、pandas对象、以DataFrame/Series为值的字典作为输入，其余参数必须以参数名=参数值的关键字形式传入，括号缺失、符号错写都会触发语法判定异常。

1. 关键字参数把=错写为: #

这是最高发的场景，手滑把参数赋值的等号写成冒号后，这部分参数会被直接判定为集合内的键值对触发报错。
错误示例：

import pandas as pd
result = pd.concat(
    [user_df, order_df],
    axis: 1, # 错把=写成:
    ignore_index: True # 错把=写成:
)

修复：将所有关键字参数里的冒号替换为等号即可。

result = pd.concat(
    [user_df, order_df],
    axis=1,
    ignore_index=True
)

2. 待拼接对象的包裹括号缺失 #

如果要给concat传入字典格式的待拼接对象（用来给每个子数据打分组键），必须用大括号把所有键值对完整包裹成一个字典整体，漏写外层大括号时，内部的键值对会直接暴露在函数参数位，被解析为集合内容触发报错。
错误示例：

# 漏了包裹字典的大括号，键值对直接写在了参数位
result = pd.concat(
    "train": train_df,
    "test": test_df,
    axis=0
)

修复：给待拼接的字典内容补全外层大括号，作为第一个参数完整传入。

result = pd.concat(
    {"train": train_df, "test": test_df},
    axis=0
)

3. 包裹待拼接对象的括号类型错用 #

如果不需要分组键，待拼接的DataFrame列表必须用方括号[]包裹，手滑写成大括号且内部混入键值对语法时就会触发报错。
错误示例：

# 错把列表的方括号写成大括号，内部还混入了键值对格式
result = pd.concat(
    {user_df, "rename": order_df}
)

修复：根据需求选择正确的包裹格式即可：

# 不需要分组键时，用方括号包裹成列表
result = pd.concat([user_df, order_df])
# 需要分组键时，统一写成标准字典格式
result = pd.concat({"user": user_df, "order": order_df})

4. Pylance缓存误报 #

如果核对完所有语法都没有问题，就是Pylance语言服务缓存卡住导致的误判，按以下步骤修复：

• 快捷键Ctrl+Shift+P（Mac端为Cmd+Shift+P）调出VSCode命令面板
• 执行Pylance: Restart Language Server重启语言服务
• 若仍未消除报错，执行命令面板内的Developer: Reload Window重载整个编辑器窗口即可。

内容的提问来源于stack exchange，提问作者stack programming