VS Code需手动配置Python解释器并安装官方扩展才能运行Python代码；必须确保系统已安装Python、路径正确、扩展启用、文件路径为英文，且使用“Run Python File in Terminal”方式执行。
VS Code 本身不自带 Python 运行环境，你写完 print("Hello") 按 Ctrl+F5 跑不起来，不是配置错了，是根本没装 Python 解释器或没告诉 VS Code 哪个可用。
确认系统已安装 Python 并被 VS Code 识别
VS Code 不是 Python IDE，它靠外部解释器执行代码。如果终端里运行 python --version 或 python3 --version 报“command not found”，VS Code 就找不到解释器。
- Windows 用户优先装官方 Python 安装包（勾选 “Add Python to PATH”），别只靠 Microsoft Store 装
-
macOS 用户用
brew install python后，解释器路径通常是/opt/homebrew/bin/python3（Apple Silicon）或/usr/local/bin/python3（Intel） - Linux 用户检查
which python3输出，确保路径存在且有执行权限 - 在 VS Code 中按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Python: Select Interpreter，从列表选中一个带版本号的路径；如果列表为空，说明 VS Code 根本没扫描到任何 Python 可执行文件
安装 Python 扩展并验证基础功能
没有 Python 扩展，VS Code 就是个带语法高亮的文本编辑器，不会有智能提示、调试按钮、格式化支持。
- 在扩展市场搜
Python，安装由 Microsoft 发布的官方扩展（ID：ms-python.python） - 重启 VS Code，新建一个
hello.py文件，输入print("Hello, World!")，保存后右上角会出现 ▶️ 按钮 —— 这才是正常信号 - 如果点 ▶️ 没反应，看左下角状态栏有没有显示 Python 版本；没有就回去检查上一步的解释器选择
- 别急着装 Pylint 或 Black，先确保
Ctrl+F5（运行而不调试）能打出结果，这是最简验证通路
运行方式选错会导致“没输出”或“一闪而过”
VS Code 提供至少三种执行方式，行为完全不同，新手常混淆：
立即学习“Python免费学习笔记（深入）”；
-
Ctrl+F5：启动调试会话，适合加断点；但若脚本执行完立刻退出（比如没input()），终端窗口可能直接关闭 -
F5：同样进调试，但会读取.vscode/launch.json配置；新手没配这个文件时，VS Code 会自动生成默认配置，但容易卡在“等待连接” - 推荐新手用右键菜单 →
Run Python File in Terminal：它等价于在集成终端里执行python hello.py，输出可见、可复现、不闪退 - 如果终端报错
ModuleNotFoundError，不是代码问题，是当前终端工作目录不对 —— 确保你在hello.py所在文件夹里打开的 VS Code，或者右键时选对了文件
中文路径/文件名可能让 import 或读文件失败
哪怕解释器和扩展都装好了，用中文命名文件（如 我的第一个程序.py）或把项目放在桌面/文档等含中文路径的文件夹里，后续 import 自定义模块、用 open() 读配置都会出编码错误或 FileNotFoundError。
- 从现在开始，所有 Python 文件名、文件夹名、变量名、函数名，全部用英文小写字母 + 下划线
- 项目根目录建议建在
C:\pyproject（Win）、~/pyproject（macOS/Linux）这类纯英文路径下 - VS Code 的终端默认编码通常为 UTF-8，但 Windows 的 cmd/powershell 默认是 GBK，遇到中文路径时会解码失败；用 VS Code 内置终端（
Ctrl+`）比系统终端更可控
真正卡住人的从来不是语法，而是解释器在哪、扩展有没有生效、终端工作路径对不对、路径里有没有中文 —— 这四点理清了，print("Hello") 就一定能跑出来。
