Visual Studio 支持配置用于 Python 开发的交互式开发环境（IDE）。 可以根据偏好设置选项，以满足特定的开发环境需求。 本文介绍可用于常规布局和行为、调试、诊断和高级 Python 语言功能的选项。
Python 选项的位置
“ 工具>选项”下的 Visual Studio 工具栏中提供了 Python 配置设置。 “ 选项 ”对话框在 Python 选项卡上列出了 Python 的大多数设置：
可以配置用于调试、Pylance 语言服务器分析、conda 环境、常规环境和 交互式 Windows 的首选项。
“选项”对话框列出了文本编辑器> Python 下的其他Python 设置。 提供了滚动条、选项卡和格式设置，以及常规和高级设置的选项。 其他设置在“文本>编辑器”设置组的环境字体和颜色下可用。
注释
“选项”对话框可能包含一个实验选项卡或组，用于正在开发中的但在本文中未详细描述的功能。 可以在 Microsoft 博客上的 Python 工程文章中找到详细信息。
Python 的特定选项
在 “工具>选项>Python”下，可以为常规环境（包括 交互式 Windows、conda 环境、调试等）设置特定于 Python 的选项。
常规 Python 选项
在“工具>选项>Python>常规”下可用的选项有：
| 选项 | 违约 | Description |
|---|---|---|
| 创建虚拟环境时显示输出窗口 | 启用 | 清除以防止显示 “输出 ”窗口。 |
| 安装或删除包时显示输出窗口 | 启用 | 清除以防止显示 “输出 ”窗口。 |
| 显示用于创建环境的通知栏 | 启用 | 设置并打开具有 requirements.txt 或 environment.yml 文件的项目时，Visual Studio 会显示一个信息栏，其中包含分别创建虚拟环境或 conda 环境的建议，而不是使用默认的全局环境。 |
| 显示用于安装包的通知栏 | 启用 | 设置并打开具有不使用默认全局环境的 requirements.txt 文件的项目时，Visual Studio 会将这些要求与当前环境中安装的包进行比较。 如果缺少任何包，Visual Studio 会显示安装这些依赖项的提示。 |
| 显示用于配置测试框架的通知栏 | 启用 | 设置时，如果 Visual Studio 检测到可能包含测试但未启用测试框架的 Python 项目中的文件，Visual Studio 会提示你启用 pytest 或 unittest。 |
| 始终以管理员身份运行包管理器 | 关闭 | 始终为所有环境提升 pip install 和类似的包管理器操作的权限。 安装包时，如果环境位于文件系统的受保护区域（如 c：\Program Files），Visual Studio 会提示管理员权限。 在该提示中，可以选择始终为该环境提升安装命令。 有关详细信息，请参阅 “包”选项卡。 |
Conda 环境选项
以下选项在 “工具>选项>Python>Conda”下提供：
| 选项 | 违约 | Description |
|---|---|---|
| Conda 可执行路径 | （空白） | 指定 conda.exe 可执行文件的确切路径，而不是依赖于 Python 工作负载附带的默认 Miniconda 安装。 如果在此处提供了另一个路径，则它优先于默认安装以及注册表中指定的任何其他 conda.exe 可执行文件。 如果手动安装较新版本的 Anaconda 或 Miniconda，或者想要使用 32 位发行版，而不是默认的 64 位发行版，则可以更改此设置。 |
调试选项
以下选项在 “工具>选项>Python>调试”下提供：
| 选项 | 违约 | Description |
|---|---|---|
| 在出现错误时先提示再运行 | 启用 | 设置此选项后，Visual Studio 会提示你确认要运行出现错误的代码。 若要禁用警告，请清除此选项。 |
|
当进程异常退出时等待输入 在进程正常退出时等待输入 |
启用（对两者） | 从 Visual Studio 启动的 Python 程序在其自己的控制台窗口中运行。 默认情况下，窗口会等待你按一个键，然后再关闭它，而不管程序如何退出。 若要删除该提示并自动关闭窗口，请清除或清除这两个选项。 |
| 将程序输出定向到“调试输出”窗口 | 启用 | 在单独的控制台窗口和 Visual Studio 输出窗口中显示程序 输出 。 清除此选项以仅在单独的控制台窗口中显示输出。 |
| 在遇到 SystemExit 异常时中断，退出代码为零 | 关闭 | 如果已设置，则在异常发生时停止调试器。 在清除状态下，调试器会退出而不中断。 |
| 启用 Python 标准库的调试 | 关闭 | 允许在调试时单步执行标准库源代码，但会增加调试器启动所需的时间。 |
| 显示函数返回值 | 启用 | 在 “局部变量 ”窗口中显示函数返回值，然后在调试器中单步执行函数调用 （F10） |
| 显示变量 | 启用 | 显示四组要显示的变量以及如何设置显示格式（组、隐藏、内联）。 - 类：默认值为“组” - 受保护：默认值为内联" - 函数：默认值为“组” - 特殊：默认值为“组” |
分析选项
“ 工具>选项>Python>分析”下提供了以下选项：
| 选项 | 违约 | Description |
|---|---|---|
| 诊断模式 | 仅打开文件 | 指定语言服务器用于分析问题的代码文件，包括 工作区 和 仅打开文件。 |
| 日志级别 | 信息 | 指定要由语言服务器执行的日志记录级别。 日志记录的可能级别（在提供的信息级别增加）包括错误、警告、信息和跟踪。 |
| 类型检查 | 关闭 | 指定要执行的检查分析的类型级别： - 关闭：生成未解析的导入/变量诊断，但不执行类型检查分析 - 基本：使用非类型相关规则（关级别下的所有规则）以及基本的类型检查相关规则 |
| 导入格式 | 绝对 | 在自动导入模块（包括 绝对 或 相对）时定义默认格式。 |
| 存根路径 | <空> | 指定包含自定义类型存根的目录的路径。 每个包的类型存根文件应位于其自己的子目录中。 |
| 搜索路径 | <空> | 指定导入解析的搜索路径。 如果有多个路径，则接受指定为字符串的路径， ["path 1","path 2"]并用逗号分隔。 |
| 类型化路径 | <空> | 指定 Visual Studio 使用自定义 Typeshed 文件的路径，而不是其捆绑版本。 |
| 自动添加常见搜索路径，例如“src” | 启用 | 指示是否根据预定义名称自动添加搜索路径，例如 src。 |
| 为语言功能（例如自动导入、添加导入、工作区符号等）索引已安装的第三方库和用户文件。 | 关闭 | 指定语言服务器是否应在启动时为用户文件编制索引并安装第三方库。 索引在功能中提供了一组更完整的符号，包括自动导入、快速修复、自动完成等。 - 设置后，Visual Studio 会索引已安装包的顶级符号，例如包/__init__.py下的所有符号，以及最多 2,000 个用户文件中的所有符号。 - 未设置时，Visual Studio 会显示在以前打开或由编辑器加载的文件中引用或使用的符号。 |
交互式 Windows 选项
以下选项在 “工具>选项>Python>交互式 Windows”下提供：
| 选项 | 违约 | Description |
|---|---|---|
| 脚本 | n/a | 指定一个通用文件夹，以存放要在所有环境的交互式 Windows中应用的启动脚本。 有关详细信息，请参阅 启动脚本。 注意：此功能在 Visual Studio 版本中可能不起作用。 |
| 向上/向下箭头导航历史记录 | 启用 | 使用箭头键在 交互 窗口中浏览历史记录。 清除此设置，以便使用箭头键在 交互 窗口的输出中进行导航。 |
| 完成模式 | 仅评估不含函数调用的表达式 | 在 交互 窗口中确定表达式上的可用成员的过程可能需要评估当前未完成的表达式，这可能会导致多次调用副作用或函数。 默认设置： 仅计算不带函数调用的表达式 将排除看似调用函数的表达式，但计算其他表达式。 例如，它会计算语句 a.b，但不会计算语句 a().b。
禁止计算表达式 避免所有副作用，仅使用常规的 IntelliSense 引擎来提供建议。
计算所有表达式 将计算完整的表达式以获取建议，而不考虑副作用。 |
| 隐藏静态分析建议 | 关闭 | 设置时，仅显示通过计算表达式获取的建议。 如果将 完成模式 值 从不计算表达式 结合使用，交互窗口 中将不会显示有用的完成。 |
Python 的文本编辑器选项
在 “文本编辑器>Python”下，有滚动条、选项卡和格式选项，以及常规和高级设置：
常规 Python 编辑器选项
“ 工具>选项>文本编辑器>Python>常规”下提供了以下选项：
| 选项 | 违约 | Description |
|---|---|---|
| 自动列出成员 | 启用 | 将此选项设置为自动列出成员以完成代码语句。 |
| 隐藏高级成员 | 启用 | 启用 “自动列表成员 ”选项后，将此选项设置为隐藏完成建议中的高级成员。 高级成员是使用频率低于其他成员的成员。 |
| 参数信息 | 启用 | 设置时，将鼠标悬停在参数上会显示详细信息，例如项定义和文档链接。 |
| 启用虚拟空间 | 启用 | 设置后，在每行代码的末尾插入空格。 选择此选项可在代码旁的固定位置放置注释。 在列选择模式下启用虚拟空间模式。 如果未启用 虚拟空间 模式，插入点将从一行的末尾直接移动到下一行的第一个字符。 注意：此选项受 文本编辑器>“所有语言>常规>启用”虚拟空间 全局设置的影响。 如果未启用全局设置，则无法在语言级别启用此选项。 |
| 自动换行 | 关闭 | 设置此选项，以允许长行代码根据编辑器视区宽度自动换行。 |
| 显示换行的视觉符号 | 关闭 | 启用 Word wrap 选项后，将此选项设置为显示视觉标志符号。 |
| 行号 | 关闭 | 设置此选项可在编辑器的左边距中显示每行代码的行号。 |
| 启用单击 URL 导航 | 启用 | 设置后，可以单击 URL 浏览到目标位置。 |
| 导航栏 | 关闭 | 设置此选项可启用代码窗口顶部的下拉框。 这些字段可帮助你导航到代码库中的代码，你可以在其中选择要直接转到的类型或成员。 注意：此选项受 文本编辑器>“所有语言>常规>启用”导航栏 全局设置的影响。 有关详细信息，请参阅 导航代码> 导航栏。 |
| 自动大括号完成 | 启用 | 设置后，Visual Studio 会在您输入代码时自动为每个打开的大括号添加相应的闭合大括号。 |
| 在没有选择的情况下将剪切或复制到空白行 | 启用 | 默认情况下，当没有显式选择时，Visual Studio 会剪切或复制整个代码行。 使用此选项可在空白行上调用时启用或禁用此剪切或复制行为。 |
有关详细信息，请参阅 “选项”对话框：文本编辑器 > 常规。
高级 Python 编辑器选项
以下选项在 “工具>选项>文本编辑器>Python>高级”下提供：
| 选项 | 违约 | Description |
|---|---|---|
| 提供自动导入补全功能 | 启用 | 设置后，Visual Studio 在完成时提供自动导入。 |
| 自动为函数添加方括号 | 关闭 | 设置后，Visual Studio 会在编辑器中输入代码时自动为函数添加方括号。 |
字体和颜色选项
当文本编辑器组设置为 Python 时，环境>下提供了其他 Python 选项：
Python 选项的名称都以“Python”为前缀，并具有自我解释性。 所有 Visual Studio 颜色主题的默认字体为 10 pt Consolas 常规（而不是粗体）。 默认颜色因主题而异。 通常，可以更改字体或颜色，以便更轻松地阅读文本。