VSCode怎么运行Python脚本_VSCode执行和调试Python代码的方法教程

答案：在vscode中运行python脚本需先安装Python及Python扩展，再通过命令面板选择正确的解释器，随后可点击右上角运行按钮或使用集成终端执行脚本，调试时可设置断点并利用调试控制条进行单步执行、变量监视等操作，常见问题如模块未找到、语法错误、文件路径错误等可通过检查环境配置、依赖安装和路径设置解决。

在VSCode里运行Python脚本，其实核心就是两件事：让VSCode知道用哪个Python解释器来执行你的代码，以及如何触发这个执行过程。最直接的方法就是利用VSCode内置的终端或者它强大的调试功能。只要你的Python环境配置得当，VSCode的Python扩展也安装了，那么无论是点击运行按钮，还是设置断点进行调试，都变得非常直观。

解决方案

要让VSCode顺利地跑起来你的Python代码，我们得先确保几个基础条件满足，然后才能谈到具体的执行和调试。

首先，你得确保系统里已经安装了Python，并且VSCode也已经装好。接着，最关键的一步是安装VSCode的“Python”扩展，这是微软官方出品的，它能提供代码补全、语法检查、调试等一系列功能。装好之后，重启一下VSCode通常是个好习惯。

运行Python脚本

立即学习“Python免费学习笔记（深入）”；

1. 选择Python解释器： 这是第一步，也是最重要的一步。打开你的Python文件后，按

   Ctrl+Shift+P

   (macos:

   Cmd+Shift+P

   ) 调出命令面板，输入“Python: select Interpreter”，然后从列表中选择你想要使用的Python版本。比如，你可能装了Python 3.8、3.9，或者某个虚拟环境里的Python，这里要选对。选错了解释器，轻则代码跑不起来，重则依赖包找不到，那可就麻烦了。

2. 通过编辑器直接运行：

   • 当你打开一个

     .py

     文件时，VSCode右上角通常会出现一个小的“播放”按钮（一个三角形）。点击它，VSCode就会在集成终端里运行你的脚本。

   • 或者，你可以在编辑器里右键点击，选择“Run Python File in Terminal”。这两种方式本质上都是在VSCode的集成终端里执行

     python your_script.py

     命令。

3. 在集成终端中手动运行：

   • 打开VSCode的集成终端（

     Ctrl+``

     或者从“View”菜单选择“Terminal”）。

   • 确保终端的当前工作目录是你Python脚本所在的目录。如果不是，用

     cd

     命令切换过去。

   • 直接输入

     python your_script.py

     并回车。这种方式的好处是，你可以带上各种命令行参数，或者在执行前先做一些环境设置。

调试Python代码

调试是找出代码问题、理解程序流程的利器。VSCode的Python调试功能非常强大。

1. 设置断点： 在你想要暂停代码执行的行号左侧点击一下，会出现一个红点，这就是断点。程序运行到这里就会停下来。

2. 启动调试：

   • 点击VSCode左侧活动栏的“运行和调试”图标（一个带有播放按钮的虫子）。
   • 如果你是第一次调试，它会提示你选择一个调试配置。最简单的是选择“Python File”，它会直接运行当前打开的Python文件并进入调试模式。
   • 如果你需要更复杂的配置，比如传递命令行参数、设置环境变量、或者调试特定的模块，你可以选择“Add Configuration…”来生成一个

     launch.JSon

     文件。在这个文件里，你可以自定义各种调试选项。

3. 调试控制：

   • 程序在断点处暂停后，VSCode顶部会出现一个调试控制条：
     • 继续 (continue): 运行到下一个断点或程序结束。
     • 单步跳过 (Step Over): 执行当前行，如果当前行是一个函数调用，则跳过函数内部，直接到下一行。
     • 单步调试 (Step Into): 如果当前行是一个函数调用，则进入函数内部进行调试。
     • 单步跳出 (Step Out): 从当前函数中跳出，回到调用它的地方。
     • 重启 (Restart): 重新启动调试会话。
     • 停止 (Stop): 停止调试。
   • 在调试过程中，你可以在左侧的“变量”面板查看当前作用域内的所有变量值，在“监视”面板添加你特别关心的变量，在“调用堆栈”面板查看函数调用链。这些工具能帮你清晰地了解程序运行时的状态。

如何确保VSCode正确识别我的Python环境？

这真的是个老生常谈的问题，但它又是如此关键，以至于我每次帮朋友解决VSCode Python问题时，第一步都是问：“你选对解释器了吗？”很多时候，代码没法运行，或者依赖包找不到，根源就在这里。

VSCode识别Python环境主要依赖于它安装的Python扩展。这个扩展会扫描你的系统，尝试找到所有已安装的Python解释器，包括那些在虚拟环境（如

venv

、

conda

）里的。

选择解释器的正确姿势：

1. 命令面板大法： 最稳妥的方法是使用

   Ctrl+Shift+P

   (macOS:

   Cmd+Shift+P

   ) 调出命令面板，然后输入“Python: Select Interpreter”。VSCode会列出它找到的所有Python解释器。这里你得仔细看看，确保选中了你项目所需的那个。比如，你的项目可能依赖Python 3.9，但你误选了系统自带的Python 3.8，那肯定会出问题。

2. 虚拟环境的优先级： 如果你的项目使用了虚拟环境（强烈推荐！），那么在项目文件夹内打开VSCode时，Python扩展通常会智能地检测到这个虚拟环境，并将其推荐为默认解释器。如果没自动选上，你也可以通过上述命令面板手动选择。选择虚拟环境的好处是，项目的依赖包都安装在这个独立的环境里，不会污染全局Python，也不会与其他项目的依赖冲突。

3. settings.json

   的幕后： 虽然现在VSCode更推荐通过ui来选择解释器，但了解其背后的机制也很有用。当你选择一个解释器后，VSCode会在你的工作区（

   .vscode

   文件夹下的

   settings.json

   ）或用户设置中更新

   "python.defaultInterpreterPath"

   （或者更旧的

   "python.pythonPath"

   ）这个配置项。这个路径就是VSCode用来启动Python进程的解释器路径。如果你遇到解释器选择上的怪异行为，检查这个文件有时能发现端倪。

可能遇到的坑：

• 找不到解释器： 确保Python已经正确安装，并且其路径被添加到了系统的环境变量PATH中。如果你使用的是windows，安装Python时勾选“Add Python to PATH”非常重要。
• 虚拟环境未激活： 有时候你虽然选择了虚拟环境的解释器，但终端里显示的还是全局Python。这通常是因为VSCode的终端默认没有“激活”虚拟环境。你可以在终端里手动运行虚拟环境的激活脚本（例如

  source .venv/bin/activate

  或

  ..venvScriptsactivate

  ），或者在

  launch.json

  中配置

  "justMyCode": false

  来确保调试器能正确进入虚拟环境。

• 多版本Python冲突： 尤其是在macOS或linux上，系统可能自带一个老版本的Python。确保你的VSCode指向的是你手动安装的、更新的Python版本。

VSCode调试Python时，有哪些高级技巧可以提升效率？

调试不仅仅是设置断点、单步执行那么简单。VSCode提供了很多高级调试功能，用好了能大大提升我们排查问题和理解代码的效率。在我看来，这些技巧才是真正让VSCode调试变得强大的地方。

1. 条件断点 (Conditional Breakpoints)：

   • 你有没有遇到过一个循环执行几千次，但你只关心某个特定条件下的迭代？普通断点会让你点到手软。
   • 右键点击断点，选择“Edit Breakpoint”，然后输入一个Python表达式。只有当这个表达式评估为

     True

     时，断点才会触发。比如，

     i == 100

     或者

     my_variable is None

     。这简直是调试大数据量或复杂逻辑时的救星。

2. 日志点 (Logpoints)：

   • 有时候你不想暂停程序，只想在某个点打印一些变量值，但又不想改动代码加

     print()

     。

   • 右键点击断点，选择“Add Logpoint”。输入一个字符串，里面可以包含用大括号包起来的Python表达式，比如

     Value of x: {x}, y: {y}

     。程序执行到这里时，它会在调试控制台打印这条信息，但不会暂停执行。这比频繁地添加和删除

     print

     语句优雅多了。

3. 变量观察 (Watch Expressions)：

   • 在调试过程中，左侧的“变量”面板会显示当前作用域内的所有变量。但如果你有很多变量，或者只想关注某个表达式的值，比如

     len(my_list)

     ，那么“监视”面板就派上用场了。

   • 在“监视”面板中点击加号，输入你想观察的变量名或表达式。它会实时更新这些值，即使它们不在当前作用域的直接显示列表中。

4. 修改变量值 (Changing Variable Values)：

   • 调试时发现某个变量值不对，想临时改一下看看后续逻辑？在“变量”面板中，你可以直接双击一个变量的值，然后输入新值并回车。这能让你在不重启程序的情况下，快速测试不同的输入或状态。

5. 自定义

   launch.json

   ：深入调试配置

   • 当你需要更精细的控制，比如传递命令行参数、设置环境变量、或者调试特定的模块时，

     launch.json

     是你的好朋友。

   • 点击调试面板顶部的齿轮图标，选择“Python File”，VSCode会为你生成一个

     launch.json

     文件。你可以添加多个配置（

     configurations

     数组），每个配置都有自己的

     name

     、

     type

     、

     request

     （

     launch

     用于启动，

     attach

     用于附加到已运行进程）、

     program

     （要运行的脚本）、

     args

     （命令行参数）、

     cwd

     （工作目录）、

     env

     （环境变量）等。

   • 例如，调试一个需要特定参数的脚本：

     {     "name": "Run Script with Args",     "type": "python",     "request": "launch",     "program": "${file}", // 当前打开的文件     "args": ["--input", "data.txt", "--output", "result.csv"],     "console": "integratedTerminal" }
   • 再比如，调试一个web应用，需要设置环境变量：

     {     "name": "Debug Flask App",     "type": "python",     "request": "launch",     "module": "flask",     "env": {         "FLASK_APP": "app.py",         "FLASK_ENV": "development"     },     "args": ["run", "--no-debugger", "--no-reloader"],     "jinja": true,     "console": "integratedTerminal" }
   • 通过

     launch.json

     ，你可以为不同的场景创建不同的调试配置，避免每次调试都手动设置。

6. 远程调试 (Remote Debugging)：

   • 如果你的Python代码运行在远程服务器、docker容器或WSL中，你仍然可以使用VSCode进行调试。这通常涉及到在远程环境安装

     debugpy

     库，并在

     launch.json

     中配置一个

     attach

     类型的调试配置。

   • 例如，在远程机器上运行

     python -m debugpy --listen 5678 --wait-for-client your_script.py

     ，然后在VSCode中配置：

     {     "name": "Python: Remote Attach",     "type": "python",     "request": "attach",     "port": 5678,     "host": "localhost" // 或者远程服务器的IP }
   • 这能让你在本地VSCode享受完整的调试体验，仿佛代码就在本地运行一样。

运行Python脚本时，常见的错误和解决方案是什么？

在VSCode里跑Python，虽然大多数时候都很顺滑，但总会遇到那么几个让你挠头的错误。这些错误往往不是VSCode本身的问题，而是环境、路径或代码逻辑上的疏忽。我个人就没少踩这些坑，所以总结一些常见的错误和对应的解决方案，希望能帮你少走弯路。

1. ModuleNotFoundError: No module named 'xxx'
   • 问题描述： 这是最常见的错误之一，意味着Python解释器找不到你代码中

     import

     的某个模块或包。

   • 解决方案：
     • 检查依赖是否安装： 你是不是忘了

       pip install xxx

       ？或者你的项目依赖文件

       requirements.txt

       里有，但你没运行

       pip install -r requirements.txt

       ？

     • 解释器选择是否正确： 确保VSCode当前使用的Python解释器是你安装了这些依赖的那个。比如，你可能在全局Python里装了

       requests

       ，但VSCode却在用一个没有

       requests

       的虚拟环境。参考上面“如何确保VSCode正确识别我的Python环境？”部分。

     • sys.path

       问题： 有时候是因为Python找不到你的模块文件。确保你的模块文件在Python的搜索路径中。如果你的脚本需要导入同目录下的其他模块，通常是没问题的。但如果是子目录或者其他地方，你可能需要调整

       PYTHONPATH

       环境变量，或者确保你的项目结构符合Python的包规范。

2. SyntaxError: invalid syntax

   或

   IndentationError: expected an indented block
   • 问题描述： Python对语法和缩进要求非常严格。

     SyntaxError

     通常是写错了关键字、括号不匹配等；

     IndentationError

     则是因为缩进不一致（比如混用了空格和Tab，或者缩进层级不对）。

   • 解决方案：
     • Linter提示： VSCode的Python扩展集成了Pylint、Flake8等Linter工具。它们会在你写代码的时候就标出这些语法错误，通常红色的波浪线或下划线很显眼。注意看这些提示。
     • 仔细检查代码： 尤其是在复制粘贴代码后，很容易引入隐藏的字符或错误的缩进。VSCode可以帮助你显示空白字符（

       Ctrl+Shift+P

       -> “Toggle Render Whitespace”）。

     • 统一缩进： 在VSCode底部状态栏，你可以看到当前文件的缩进方式（比如“Spaces: 4”）。确保整个项目都使用统一的缩进方式。

3. FileNotFoundError: [errno 2] No such file or Directory: 'xxx.txt'
   • 问题描述： 你的Python脚本尝试打开或访问一个文件，但系统找不到这个文件。
   • 解决方案：
     • 相对路径与绝对路径： 当你用相对路径（比如

       data.txt

       ）访问文件时，Python会从当前工作目录开始查找。

       • 确认当前工作目录： 在脚本中打印

         import os; print(os.getcwd())

         来查看程序运行时认为的当前工作目录是哪里。

       • 调整工作目录： 如果你的脚本在

         /project/src/main.py

         ，而数据文件在

         /project/data/data.txt

         ，那么直接在

         main.py

         里写

         open('data/data.txt')

         可能就会出错，因为相对路径是相对于

         main.py

         所在的目录。你可以：

         • 将VSCode的终端工作目录切换到

           /project

           。

         • 在

           launch.json

           中设置

           cwd

           字段，比如

           "cwd": "${workspaceFolder}"

           。

         • 使用

           os.path.join(os.path.dirname(__file__), '..', 'data', 'data.txt')

           来构建相对于脚本文件本身的路径。

     • 文件路径拼写： 检查文件名和路径是否完全正确，包括大小写。

4. PermissionError: [Errno 13] Permission denied: 'xxx.txt'
   • 问题描述： 你的Python脚本没有权限读取或写入某个文件或目录。
   • 解决方案：
     • 检查文件/目录权限： 在操作系统层面，确保你的用户账户对目标文件或目录有读写权限。在Linux/macOS上，可以使用

       ls -l

       和

       chmod

       命令；在Windows上，右键文件/文件夹 -> 属性 -> 安全。

     • 避免在系统关键目录操作： 尽量不要尝试在系统盘根目录、程序文件目录等受保护的区域进行文件操作。
     • 临时解决方案（不推荐长期）： 在Windows上，有时以管理员身份运行VSCode可以绕过权限问题，但这通常表明你的程序设计或文件存放位置有问题，不是一个好的长期方案。

5. 解释器未找到或VSCode无法启动Python进程

   • 问题描述： VSCode报告无法找到Python解释器，或者在尝试运行/调试时报错说无法启动Python进程。
   • 解决方案：
     • Python是否正确安装并添加到PATH： 确保Python本身已经正确安装，并且其可执行文件（

       python.exe

       或

       python3

       ）的路径在系统的环境变量PATH中。

     • VSCode中重新选择解释器： 即使你之前选择过，有时环境变动后，VSCode可能会“忘记”。重新通过

       Ctrl+Shift+P

       -> “Python: Select Interpreter”来选择一次。

     • 重启VSCode： 有时候，简单的重启可以解决一些VSCode内部状态同步的问题。
     • 检查VSCode日志： 可以在“Help”菜单中找到“Toggle Developer Tools”，在Console里查看是否有更详细的错误信息。

这些错误虽然烦人，但大多数都有明确的解决方案。关键是理解错误信息背后的含义，并系统性地排查。一个良好的开发习惯，比如使用虚拟环境、定期检查依赖、注意文件路径，可以大大减少这些问题的发生。