VS Code运行 pytest_hello_world.py

在 VS Code 中运行 pytest_hello_world.py 更便捷，支持图形化操作、断点调试和结果可视化，步骤如下（含环境配置、运行方式、调试技巧）：

一、前置准备：VS Code 安装必要插件

首先确保安装 Python 相关插件（核心支持 pytest 运行）：

1. 打开 VS Code → 左侧「扩展」（快捷键 Ctrl+Shift+X / Cmd+Shift+X）。
2. 搜索并安装以下插件：
   • Python （微软官方插件，必备，支持 Python 代码解析、运行和调试）。
   • Pytest Explorer （可选，可视化管理测试用例，点击即可运行，推荐新手）。

二、核心步骤：在 VS Code 中运行 pytest 用例

假设已编写 pytest_hello_world.py（参考上一轮的测试代码），且 VS Code 已打开该文件所在的「工作区」（重要！需将文件所在文件夹添加到 VS Code 工作区，否则可能识别不到用例）。

方式 1：直接在终端运行（和命令行一致，最灵活）

VS Code 内置终端，无需切换窗口，直接执行命令：

1. 打开终端：顶部菜单栏 →「终端」→「新建终端」（快捷键 Ctrl+`` / Cmd+``）。
2. 确保终端的「环境正确」：
   • 若使用虚拟环境，需在终端激活（如 venvScriptsactivate（Windows）或 source venv/bin/activate（Mac/Linux））。
   • 若未安装 pytest，先在终端执行 pip install pytest。
3. 运行命令（和之前一致）：

   # 方式 1：运行整个文件
   pytest pytest_hello_world.py -v
   
   # 方式 2：运行文件中的单个用例
   pytest pytest_hello_world.py::test_hello_world -v
   

4. 查看结果：终端会直接输出测试通过/失败信息，格式和命令行一致。

方式 2：通过 Python 插件的「运行测试」功能（图形化操作）

Python 插件内置 pytest 集成，无需手动输命令，点击即可运行：

1. 打开 pytest_hello_world.py 文件。
2. 观察代码左侧：
   • 以 test_ 开头的函数（如 test_hello_world）上方会出现「运行测试」/「调试测试」的按钮（小三角/小虫子图标），点击即可直接运行该用例。
   • 若未显示按钮，点击 VS Code 左侧「测试」（快捷键 Ctrl+Shift+T / Cmd+Shift+T），再点击顶部「配置测试」。
3. 配置测试框架：
   • 弹出选择框时，选择「pytest」→ 选择测试用例所在的文件夹（如当前文件所在目录）→ 选择测试文件模式（默认即可，如 test_*.py）。
4. 配置完成后：
   • 左侧「测试」面板会列出所有识别到的用例（如 test_hello_world、test_addition）。
   • 点击用例旁的「运行」按钮（小三角）即可执行，通过/失败会显示绿色对勾/红色叉号。

方式 3：使用 Pytest Explorer 插件（可视化管理用例）

若安装了 Pytest Explorer 插件，操作更直观：

1. 安装后，VS Code 左侧会出现「Pytest」面板（若未显示，点击顶部「查看」→「打开视图」→「Pytest」）。
2. 插件会自动扫描工作区中的 pytest 用例，以树形结构展示。
3. 点击用例旁的「运行」按钮，或右键选择「Run Test」，即可执行，结果会实时更新（绿色=通过，红色=失败）。

三、进阶：调试 pytest 用例（打断点排查问题）

当测试用例失败时，可通过调试模式逐步排查：

1. 在代码中设置断点：点击代码行号左侧，出现红色圆点（如在 assert result == "helloworld" 行设置断点）。
2. 启动调试：
   • 方式 1：点击用例上方的「调试测试」按钮（小虫子图标）。
   • 方式 2：左侧「测试」面板 → 右键目标用例 →「调试测试」。
3. 调试控制：
   • 顶部会出现调试工具栏：「继续」（F5）、「单步跳过」（F10）、「单步进入」（F11）、「退出调试」（Shift+F5）。
   • 调试时可查看变量值（左侧「变量」面板）、监视表达式（「监视」面板），逐步定位断言失败或逻辑错误的原因。

四、常见问题解决

1. VS Code 识别不到 pytest 用例 ：
   • 确保已将文件所在文件夹添加到 VS Code 工作区（「文件」→「打开文件夹」）。
   • 检查测试文件/用例命名是否符合规则（文件以 test_ 开头，用例以 test_ 开头）。
   • 确认终端环境已安装 pytest（执行 pytest --version 验证，若提示「pytest 不是内部或外部命令」，则重新安装 pip install pytest）。
2. 运行时提示「No module named pytest」 ：
   • 原因：VS Code 未使用安装 pytest 的 Python 环境（如虚拟环境未激活，或选择了全局 Python 而非虚拟环境的 Python）。
   • 解决：点击 VS Code 右下角的「Python 环境选择器」（显示当前 Python 路径的地方），选择已安装 pytest 的环境（如虚拟环境的 Python.exe）。
3. Pytest Explorer 插件扫描不到用例 ：
   • 点击插件面板顶部的「刷新」按钮（圆形箭头），重新扫描。
   • 若仍不行，打开插件设置（右键 Pytest Explorer →「扩展设置」），确认「Pytest: Python Path」已选择正确的 Python 环境。

总结

VS Code 中运行 pytest_hello_world.py 的核心是「环境正确 + 用例识别」：

• 新手推荐「方式 2」（Python 插件内置功能），无需配置，点击即可运行。
• 频繁调试用例推荐「方式 3 + 调试模式」，可视化且高效。
• 熟悉命令行的用户可直接用「方式 1」，灵活快捷。

按以上步骤操作，即可在 VS Code 中快速运行和调试 pytest 测试用例。

审核编辑 黄宇