如何在Visual Studio Code中自动显示函数调用的灰色内联参数名？

要实现调用函数时自动显示灰色的参数名（如change_text(text="Hello World!")），核心是配置VS Code中Python语言服务（推荐用Pylance，官方默认且功能完善）的**嵌入提示（Inlay Hints）**设置，具体操作如下：

步骤1：确认启用Pylance插件 #

确保你正在使用Pylance作为Python语言服务：

• 打开扩展面板（Ctrl+Shift+X / Cmd+Shift+X），搜索并安装Pylance（如果未安装）。
• 点击Python插件的设置齿轮，选择"Configure Extension Settings"，在"Python: Language Server"选项中选择Pylance。

步骤2：配置参数名嵌入提示 #

方法1：通过UI设置 #

1. 打开设置面板（Ctrl+, / Cmd+,）。
2. 在搜索框输入python.analysis.inlayHints.parameterNames。
3. 将选项设置为以下值之一：
   • literals：仅当参数是字面量（比如字符串、数字、布尔值）时显示参数名，符合你示例中"Hello World!"的场景。
   • all：对所有参数都显示参数名，不管参数是变量还是字面量。
4. 确保总开关python.analysis.inlayHints.enabled处于开启状态（默认是开启的）。

方法2：直接修改settings.json #

如果UI设置不生效，手动编辑配置文件：

1. 按Ctrl+Shift+P / Cmd+Shift+P，输入Preferences: Open Settings (JSON)并打开。
2. 添加或修改以下配置项：

   "python.analysis.inlayHints.enabled": true,
   "python.analysis.inlayHints.parameterNames": "literals"
   

3. 保存文件后，按Ctrl+Shift+P执行Reload Window，让设置生效。

常见问题排查 #

• 如果之前修改设置无效，大概率是没有找到Pylance的专属设置，误改了其他无关选项（比如通用编辑器的inlay hints设置）。
• 若使用的是Jedi语言服务，该功能不支持，建议切换到Pylance。
• 确保Pylance插件是最新版本，旧版本可能存在功能缺失。

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