简介这份资源面向刚接触 Python 开发或希望在轻量编辑器中搭建运行环境的初学者聚焦于在 Visual Studio Code 中运行 Python 文件的完整流程。内容从安装 Python 与 VSCode 起步依次讲解安装官方 Python 扩展、创建 basic.py 文件、选择 Python 解释器以及通过右键菜单、运行按钮和终端指定路径三种方式执行脚本并展示终端输出结果帮助读者快速打通编辑、解释器配置到运行调试的链路。资源包为 1 个 docx 文档约 303KB以图文步骤形式组织便于按顺序对照操作。目前已有 535 人浏览学习适合需要一份清晰入门指引、想减少环境配置试错成本的 Python 新手参考。1. 在 VSCODE 中运行 Python 文件为什么你的 F5 按下去没反应很多人第一次在 VSCODE 里跑 Python都会经历同一个瞬间装好了编辑器写了几行print按下 F5结果弹出一个看不懂的配置文件或者干脆报一句No module named xxx。这不是你笨而是 VSCODE 本身只是一个编辑器它不负责“运行”这件事运行这件事被交给了调试器、终端和解释器三方协作。标题里说的“在 VSCODE 中运行 Python 文件”本质上是把这三方串起来让 VSCODE 知道用哪个 Python、用什么方式启动、输出到哪里看。这件事适合谁适合刚把 Python 装好、准备用 VSCODE 写第一个脚本的新手也适合已经会写代码、但每次运行都要切回命令行敲python xxx.py的老手。把运行链路理顺之后你能在编辑器里直接断点、看变量、传参数省掉大量来回切换。下面按“先跑通、再调参、再避坑”的顺序讲每一步都能直接抄。2. 先分清三种运行方式终端、调试、交互窗口2.1 终端直接跑最接近命令行的方式在 VSCODE 里按Ctrl打开集成终端确认提示符前面有虚拟环境名然后直接敲命令。这是最不容易翻车的方式因为它的行为和你在系统终端里完全一致。# 确认当前用的是哪个 Python python --version # 或 macOS/Linux 下 python3 --version # 运行当前目录下的脚本 python hello.py逻辑说明python --version用来确认终端里的解释器是不是你预期的那一个。很多人系统里同时有多个 Python终端默认的可能不是 VSCODE 右下角显示的那个。参数说明hello.py换成你的文件名即可路径带空格时用引号包起来。如果这一步就报command not found说明 Python 没进 PATH先解决安装问题别急着往下走。2.2 调试运行F5 背后的配置逻辑F5 走的是调试器它需要一个launch.json告诉它“用哪个解释器、跑哪个文件、要不要传参”。第一次按 F5 时 VSCODE 会提示你选择环境选“Python File”即可自动生成配置。{ version: 0.2.0, configurations: [ { name: Python: 当前文件, type: debugpy, request: launch, program: ${file}, console: integratedTerminal, cwd: ${workspaceFolder}, args: [] } ] }逻辑说明program用${file}表示运行当前打开的文件切文件不用改配置。console设成integratedTerminal是为了让input()能正常接收输入用默认的内部控制台时输入会卡住。cwd决定相对路径的基准目录读文件报FileNotFoundError时先查这里。args是命令行参数数组需要传参时往里加字符串。2.3 交互窗口适合验证片段而不是跑完整脚本在文件里选中几行按ShiftEnter代码会发到交互窗口执行。它适合验证一个函数、试一个库的返回值但不适合跑有if __name__ __main__结构的完整脚本因为执行上下文和直接运行不一样。常见做法是写脚本用终端或 F5验证片段用交互窗口。3. 把解释器和虚拟环境配对选错了后面全是坑3.1 用命令面板指定解释器按CtrlShiftP输入Python: Select Interpreter在列表里选带.venv或venv路径的那一项。选完之后VSCODE 右下角状态栏会显示当前解释器集成终端新开的会话也会自动激活它。# 在项目根目录创建虚拟环境 python -m venv .venv # Windows 激活 .venv\Scripts\activate # macOS / Linux 激活 source .venv/bin/activate # 激活后安装依赖 pip install requests逻辑说明虚拟环境把项目依赖和系统 Python 隔开避免 A 项目升级库把 B 项目跑挂。参数说明.venv是目录名可以改但改了之后Select Interpreter里要选对应路径。激活成功的标志是终端提示符前面出现(.venv)。如果 VSCODE 终端没自动激活检查设置里python.terminal.activateEnvironment是否为真。3.2 依赖装完仍报 ModuleNotFoundError 的排查顺序先确认三件事终端提示符有没有(.venv)、pip -V显示的路径是不是指向.venv、VSCODE 右下角解释器是不是同一个。三者不一致时最常见的是 pip 装到了系统 Python而运行用的是虚拟环境。解决方式是先激活环境再装或者直接用python -m pip install 包名强制用当前解释器对应的 pip。3.3 多版本 Python 共存时的选择策略系统里同时有 3.10 和 3.12 时创建虚拟环境要显式指定版本否则用的是默认那个。# 显式用 3.12 创建环境 python3.12 -m venv .venv # 查看环境里的版本 .venv/bin/python --version逻辑说明显式指定版本能避免“我明明装了 3.12为什么跑起来是 3.10”这类问题。参数说明Windows 下把python3.12换成py -3.12。选版本的原则是跟团队或部署环境保持一致别为了用新语法让线上跑不起来。4. 传参、读文件、看输出三个最容易翻车的细节4.1 命令行参数怎么传进脚本调试配置里的args数组对应sys.argv顺序和命令行一致。import sys # sys.argv[0] 是脚本名真正的参数从下标 1 开始 if len(sys.argv) 2: print(用法: python demo.py 名字) sys.exit(1) name sys.argv[1] print(f你好, {name})逻辑说明sys.argv永远是字符串列表需要数字时自己转int()。参数说明在launch.json的args里写[张三]等价于命令行python demo.py 张三。如果参数里有空格数组里写成一个完整字符串即可不用手动加引号。4.2 相对路径读文件为什么在 F5 下失效F5 运行时的当前工作目录由cwd决定默认可能是工作区根目录也可能是文件所在目录取决于配置。读文件报错时先打印os.getcwd()看实际目录。import os # 打印当前工作目录定位相对路径的基准 print(cwd:, os.getcwd()) # 更稳的做法基于脚本文件位置拼绝对路径 base os.path.dirname(os.path.abspath(__file__)) data_path os.path.join(base, data, input.txt) print(读取:, data_path)逻辑说明__file__是当前脚本路径abspath转绝对路径dirname取所在目录再拼子路径这样无论从哪里启动都能找到文件。参数说明把data/input.txt换成你的实际相对路径。这是我在多个项目里反复用到的写法比依赖cwd可靠得多。4.3 输出被截断或中文乱码怎么处理输出乱码通常出现在 Windows 终端编码和脚本编码不一致时。在脚本开头声明编码或设置终端编码为 UTF-8。# -*- coding: utf-8 -*- import sys import io # 强制标准输出用 UTF-8缓解 Windows 终端乱码 sys.stdout io.TextIOWrapper(sys.stdout.buffer, encodingutf-8) print(中文输出测试)逻辑说明Python 3 源码默认 UTF-8但终端输出编码可能不是重包装stdout能兜底。参数说明如果用了integratedTerminal仍乱码检查系统区域设置里的“Beta: 使用 Unicode UTF-8”选项。输出被截断多半是调试控制台缓冲区限制换成集成终端即可。5. 避坑与排查五条血泪记录5.1 现象F5 弹出“选择调试配置”后没反应原因没有生成launch.json或生成后program指向了不存在的文件。解决按CtrlShiftP运行Debug: Open launch.json确认program是${file}并确保当前打开的是.py文件而不是未保存的临时缓冲区。5.2 现象终端里python能用F5 报找不到模块原因终端和调试器用了不同的解释器。解决用Python: Select Interpreter统一指定然后在集成终端里python -m pip install重装依赖确保装到同一个环境。5.3 现象input()一执行就卡住原因调试控制台默认不是真实终端不支持交互输入。解决把launch.json里的console改成integratedTerminal重新 F5。5.4 现象改了代码但运行结果没变原因跑的是旧进程或者保存的是另一个同名文件。解决确认文件已保存标题栏没有圆点停止当前调试会话再重新运行。如果用了args传参检查是不是传了缓存路径。5.5 现象断点变成空心圆不生效原因断点所在文件没有被实际加载或调试器类型不匹配。解决确认type是debugpy新版而不是旧的python并检查justMyCode设置。空心圆通常表示该行不会被执行比如注释或未导入的分支。6. 进阶用任务和配置把运行变成一键操作6.1 用 tasks.json 定义常用运行命令当项目需要先跑数据预处理再跑主脚本时可以把命令固化成任务用CtrlShiftB触发。{ version: 2.0.0, tasks: [ { label: 运行主脚本, type: shell, command: ${command:python.interpreterPath}, args: [${file}], group: { kind: build, isDefault: true }, problemMatcher: [] } ] }逻辑说明${command:python.interpreterPath}会自动取当前选中的解释器路径避免写死。group.isDefault设为真后CtrlShiftB直接跑这个任务。参数说明args里可以加固定参数比如[--mode, dev]。这套配置适合把“激活环境 装依赖 跑脚本”串成一条链。6.2 用 settings.json 统一项目级行为把解释器路径、终端激活、格式化规则写进工作区设置团队协作时少很多“在我机器上能跑”的争论。{ python.defaultInterpreterPath: ${workspaceFolder}/.venv/bin/python, python.terminal.activateEnvironment: true, python.analysis.typeCheckingMode: basic, files.encoding: utf8 }逻辑说明defaultInterpreterPath指定默认解释器Windows 下路径换成.venv\\Scripts\\python.exe。typeCheckingMode设成basic能在写代码时提前发现类型问题。参数说明这些设置放在.vscode/settings.json里随项目走不要只改用户级设置否则换台机器又得重来。6.3 验证运行链路是否真的通了一个可靠的验证方法是写一个最小脚本同时覆盖参数、文件读取和输出三件事跑通它基本就说明链路没问题。import sys import os def main(): # 1. 验证参数 args sys.argv[1:] print(参数:, args) # 2. 验证工作目录 print(cwd:, os.getcwd()) # 3. 验证文件读取 base os.path.dirname(os.path.abspath(__file__)) target os.path.join(base, README.md) print(目标文件存在:, os.path.exists(target)) if __name__ __main__: main()逻辑说明三段输出分别对应参数传递、目录基准、文件访问任何一段不符合预期都能快速定位是配置问题还是代码问题。参数说明把README.md换成你项目里真实存在的文件。我一般在新环境里先跑这个脚本确认无误再开始正式开发省得后面把配置问题误判成代码 bug。6.4 一个我坚持了很久的习惯每次新建项目第一件事不是写业务代码而是先建虚拟环境、选解释器、跑一遍上面那个最小脚本。这个习惯帮我省掉了无数次“以为是代码写错了其实是解释器选错了”的排查时间。运行环境这种事前期花五分钟理顺后期能省五小时。希望帮到你。本文还有配套的精品资源点击获取