如何让VS Code检测Python代码中错误的关键字参数名称？
2026-10-4
VS Code Python 无效关键字参数检测配置方法
1. 开启Pylance内置类型检查（最便捷）
VS Code官方Python扩展默认搭载Pylance语言服务，内置Pyright类型检查器，只需修改配置即可启用检测能力：
- 打开VS Code设置页（快捷键
Ctrl+,/Cmd+,），搜索配置项python.analysis.typeCheckingMode - 将配置值修改为
basic或strict，保存后即可生效
开启后你给出的示例代码中test_function(name1=1, name2=2, name4=4)的name4参数会被直接标红，提示未预期的关键字参数错误。
2. 使用第三方静态检查工具
如果需要更丰富的代码校验规则，可以选择pylint或mypy这类成熟的Python静态检查工具：
- pylint配置
- 执行命令安装pylint：
pip install pylint - 在VS Code设置中开启
python.linting.pylintEnabled，关闭其他冲突的linter即可 - 这类无效关键字参数的问题会被pylint标记为
unexpected-keyword-arg错误
- 执行命令安装pylint：
- mypy配置
- 执行命令安装mypy：
pip install mypy - 在VS Code设置中开启
python.linting.mypyEnabled即可生效 - mypy对类型标注的支持更完善，适合有强类型校验需求的项目
- 执行命令安装mypy：
注意事项
如果函数定义中包含**kwargs参数，静态检查工具默认不会对传入的关键字参数做校验，属于预期行为。如果需要对接收**kwargs的函数也做参数校验，可以结合TypedDict和Unpack类型标注实现严格校验。
内容的提问来源于stack exchange，提问作者matthew banasik
相关产品推荐
相关产品推荐
