如何在VSCode中实现Python Literal类型的输入补全（含Jupyter）

要在VSCode的.py文件或Jupyter Notebook（.ipynb）中实现类似TypeScript的Literal类型输入补全，核心依赖Pylance语言服务，搭配必要的扩展和配置即可实现：

一、安装必备扩展 #

• Python扩展（Microsoft出品）：默认集成Pylance语言服务，是实现类型补全的核心，直接在VSCode扩展市场搜索安装即可。
• Jupyter扩展（Microsoft出品）：若需在.ipynb中使用，需安装该扩展以确保Notebook代码单元格能被Pylance正确解析。

二、配置VSCode设置 #

打开VSCode设置（快捷键Ctrl+,），调整以下关键选项：

1. 搜索python.analysis.typeCheckingMode，将值设置为basic或strict（默认off状态下不会触发Literal类型补全）。
2. 确保python.analysis.completeFunctionParens设为true，可自动补全函数括号并触发参数补全提示。

三、代码示例验证 #

使用typing.Literal（Python 3.8+支持）或typing_extensions.Literal（低版本兼容）定义类型后，即可触发补全：

from typing import Literal

def run_task(env: Literal["dev", "staging", "prod"]) -> str:
    return f"Running in {env} environment"

# 调用函数时，输入引号内会自动弹出"dev"、"staging"、"prod"的补全选项
run_task("")

在Jupyter Notebook的代码单元格中，上述代码同样会触发相同的补全效果，只要Pylance和Jupyter扩展正常启用即可。

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