排版:Alan Wang
我们很高兴地宣布 Visual Studio Code 的 Python 和 Jupyter 扩展将于 2023 年 11 月发布!
此版本包括以下公告:
- 改进了使用 Shift + Enter 在终端中运行当前行
- 弃用内置 linting 和格式设置功能
- 对 Python linting 扩展的改进
- 重新配置测试输出
- 虚拟环境停用帮助
- VS Code 中的 Python 发布视频
如果您有兴趣,可以在我们的 Python、Jupyter 和 Pylance 扩展更新日志中查看完整的改进列表。
对 Shift + Enter 在终端中运行行的改进
Python 扩展正在努力改进在未拉选要运行的代码时将代码发送到 Python REPL (Shift+Enter
) 的行为。以前,当您将光标放在一行 Python 代码上并按下 Shift+Enter
时,Python 扩展会将确切的行内容发送到 REPL,即使它会失败,例如,运行多行命令的一部分时会失败。
借助我们新的实验性智能发送功能,Python 扩展会将光标所在行周围的最小可运行代码块发送到 REPL 以执行。这可确保仅将完整和可执行的代码部分发送到 REPL。光标也会自动放置在下一个可执行行,以便在迭代执行多个代码块时提供流畅的体验。
若要试用,可以添加以下用户设置:"python.experiments.optInto: ["pythonREPLSmartSend"]
。虽然此功能目前处于实验阶段,但我们预计它将成为将来的默认行为。如果您对我们如何进一步改进此功能有任何反馈或建议,请告诉我们!
已弃用内置 linting 和格式设置功能
随着我们去年对 VS Code 中的 linting 和格式化扩展所做的所有正在进行的工作和改进,我们已弃用 Python 扩展中附带的内置 linting 和格式化功能。这包括所有 linting 和格式化命令以及设置 (python.linting.*
和 python.formatting.*
)。如果您仍在使用这些已弃用的设置,我们建议您删除它们,并改用 linting 和格式设置扩展,因为它们提供了更可配置和更灵活的体验。
如果你使用的是尚无扩展的 linter 或格式化程序,则可以为你喜欢的 Python 工具创建 linter 或格式化程序 VS Code 扩展!查看我们的 Python 工具扩展模板来快速入门。
此外,我们想重点介绍社区贡献的 Ruff 扩展。Ruff 是一个用 Rust 编写的 Python linter,它支持各种 linter,例如 pyflakes、pycodestyle、pydocstyle 等!他们最近还启用了在 VS Code 中使用 Ruff 作为格式化程序的支持 ("[python]":{"editor.defaultFormatter": "charliermarsh.ruff" }
)。试用 VS Code 中的 Python linting 和格式设置支持!
对 Python linting 扩展的改进
我们对团队支持的 linting 扩展进行了多项改进,以允许使用您最喜欢的 Python 工具获得更可配置和更灵活的体验。
Pylint、Mypy 和 Flake8 扩展现在提供设置,允许您为 linting 中排除的文件指定 glob 模式。如果您正在使用具有许多子项目的大型代码库,并且希望排除某些文件夹的 linting,这将非常有用。
这些设置分别为"pylint.ignorePatterns"
,"mypy-type-checker.ignorePatterns"
和 "flake8.ignorePatterns"
。
这些扩展还支持 cwd 设置,这允许您指定 linter 的工作目录。此设置已更新为支持 ${fileDirname}
变量 ,因此可以将工作目录动态设置为在编辑器中打开的文件的父文件夹。如果您正在使用 mono-repos,并且希望在打开不同子项目中的文件时动态更新 linter 的工作目录,这将特别有用。这些设置分别为"pylint.cwd"
,"mypy-type-checker.cwd"
和 "flake8.cwd"
。
我们还更改了 "mypy-type-checker.preferDaemon"
的默认值,仅适用于 Mypy 扩展。以前,它被设置为 true
,这意味着默认情况下将使用 Mypy 守护程序。收到反馈后,我们已将默认值更改为 false
。如果您想知道哪个值最适合您,我们建议您使用 Mypy 守护程序,前提是出于性能原因,您启用了 Mypy 将报告范围设置为整个工作区 ("mypy-type-checker.reportingScope": "workspace"
)。否则,如果报告范围设置为当前文件,建议使用扩展附带的 Mypy 可执行文件。
重新配置测试输出
我们已对启用 pythonTestAdapter
试验时在 Python 扩展中查看测试输出并与之交互的方式进行了重大改进,这是我们在几个月前宣布的。以前,测试发现和执行的输出不一致地分散在 Python 测试日志输出通道和“测试结果”面板中,某些信息在这两个位置重复。为了巩固体验,我们现在在“Test Results”面板中显示与测试执行相关的输出,并在 Python 输出通道中显示测试发现。要了解更多信息,请参阅我们的相关 wiki。
如果您使用 Pytest 并在 Workspace 的 settings.json
中设置"python.testing.pytestArgs": ["--color=yes"]
,则此新方法还支持输出中的着色。着色仅适用于“测试结果”面板中的测试执行,不适用于“Python 测试日志”面板中的发现或输出。
还有一个新按钮,允许你在发生测试发现错误时更轻松地从“测试资源管理器”视图打开测试日志。
虚拟环境停用帮助
几个月前,我们宣布了一项实验背后的新功能,该功能支持使用环境变量激活终端,旨在通过自动激活终端中的选定环境来增强您的开发工作流程,而无需显式激活命令。但是,由于没有显式激活脚本在工作,因此启用此实验时,该命令 deactivate
不再起作用。
Python 扩展现在将检测您何时尝试运行该命令 deactivate
,并显示一个帮助程序通知,该通知将指导您如何为 shell 添加脚本,以便在通过环境变量激活环境时使命令能够再次工作。它还提供了一个按钮,可以更方便地打开 shell 配置文件,以便您添加必要的脚本。
您可以在此处找到有关如何为 shell 添加必要脚本的完整文档。
如果您未参与实验,但想要试用此功能,可以添加以下用户设置:"python.experiments.optInto: ["pythonTerminalEnvVarActivation"]
。
VS Code 中的 Python 发布视频
Python 社区倡导者 Dawn Wages 介绍了 VS Code 中的 Python 发布视频中的关键发布新闻和增强功能!这些短视频将在 Visual Studio Code YouTube 频道上随所有后续版本一起发布,重点介绍关键更改和增强功能,以及演示如何与这些新功能交互的视频内容!
有关更多 Python 新闻和社区参与,请查看每月第二个星期五由 Dawn Wages 主办的 Python Pulse!
其他更改和增强功能
我们还添加了一些小的增强功能,并修复了用户请求的问题,这些问题应该会改善你在 Visual Studio Code 中使用 Python 和 Jupyter Notebook 的体验。一些值得注意的变化包括:
- 我们的文档中添加了一个新的 FastAPI 教程!了解如何在开发 FastAPI 应用程序时充分利用 VS Code 和 Python 扩展。
- Python 扩展现在会显示一条通知,以帮助在尝试在包含依赖项文件(如
requirements.txt
或requirements/*.txt
)且没有当前.venv
或者.conda
文件夹的工作区中运行或调试 Python 文件时创建虚拟环境。此通知提供了一种使用 Python:Create Environment 命令创建新虚拟环境的快速简便方法。此设置可以禁用python.createEnvironment.trigger
设置为off
。 - Python 调试器扩展现在具有特定于平台的版本,这意味着在更新时将仅安装平台所需的文件。这减小了扩展的大小,并有助于缩短启动时间。
- Tensorboard 功能现已从 Python 扩展中移出,并移至独立的 Tensorboard 扩展中。您可以在 Tensorboard 扩展 GitHub 存储库中提供反馈。
- 现在,您可以通过状态栏上的语言状态图标更轻松地启用和禁用 Pylance 自动导入完成 (pylance-release#3894)
- 用 Pylance 时 IntelliSense 支持
__setattr__
,__delattr__
以及__getattribute__
(pylance-release#4786)
我们还要特别感谢本月的贡献者:
- @PeterJClaw 在 @vscode-python #22132 中将 Python 3.12 支持将 Jedi 提升到 0.19.1
- @BoltonBailey 从 @vscode-python#22254 中的错误消息中删除不匹配的括号
- @HVbajoria 修复了 @vscode-pylint#390 中面向用户的文本中 “Python” 的大写
征集社区反馈
当我们计划和优先考虑未来的工作时,我们重视您的反馈!以下是我们希望得到反馈的几个问题:
- 重写时 Django 测试的建议设计 (@vscode-python#22206)
- 当用户在实际导入之前对方法执行 Shift+Enter 时自动导入库 (@vscode-python#22329)
通过从 Marketplace 下载 Python 扩展和 Jupyter 扩展来尝试这些新的改进,或直接从 Visual Studio Code 中的扩展视图(Ctrl + Shift + X 或 ⌘ + ⇧ + X)安装它们。可以在文档中详细了解 Visual Studio Code 中的 Python 支持。如果遇到任何问题或有建议,请在 Python VS Code GitHub 页面上提交问题。