vs code 运行 python 需同时满足三条件：安装 python 解释器并加入 path、安装 microsoft 官方 python 扩展、在 vs code 中正确选择解释器路径；缺一不可，否则运行按钮灰色、print 不输出、断点失效。
VS Code 本身不带 Python 运行能力，必须装解释器 + 官方 Python 扩展 + 正确选中解释器路径，三者缺一不可；否则你看到的“运行”按钮是灰色的，print() 不输出，断点也不生效。
Python 解释器没装或没进 PATH，VS Code 就彻底“看不见”它
很多人卡在这一步：VS Code 打开后底部状态栏根本没显示 Python 版本，命令面板里搜 Python: Select Interpreter 列表为空。这不是 VS Code 的问题，而是系统层面没准备好。
- 先在终端（Windows 命令提示符/PowerShell、macOS/Linux 终端）里执行
python --version或python3 --version，必须有输出；没有就去python.org下载安装，安装时务必勾选 Add Python to PATH - 如果已安装但终端里也报“命令未找到”，说明 PATH 没生效——重启终端，或重装时再确认勾选项
- Windows 用户注意：
py -3是微软官方启动器，比直接用python更可靠；可用py -3 --version验证
必须装 Microsoft 官方 Python 扩展，第三方“Python Support”之类无效
VS Code 的 Python 功能（调试、补全、格式化、虚拟环境识别）全部由这个扩展驱动。装错或没装，后面所有操作都白搭。
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
- 打开扩展面板（
Ctrl+Shift+X），搜Python，只认准作者是 Microsoft、图标为蓝色蛇形的那个 - 装完必须点击“重新加载”（不是关掉再开），否则扩展处于未激活状态
- 装完后随便打开一个
.py文件，应该立刻有语法高亮和右上角绿色 ▶️ 按钮；没有就说明扩展没真正启用
Python: Select Interpreter 选错路径，调试和终端就“各跑各的”
VS Code 不继承你终端里的 conda 激活状态，也不自动读取 shell 的 PATH。你手动选的解释器，只影响编辑器内功能（如调试、补全），不影响集成终端默认行为——除非你额外配置。
- 按
Ctrl+Shift+P输入Python: Select Interpreter，优先选带完整绝对路径的项，比如/Users/you/miniconda3/envs/myproj/bin/python或C:\Users\you\venv\Scripts\python.exe - 避免选只有
python3或python字样的模糊条目，它们不指向具体可执行文件 - 选完后看底部状态栏：必须显示类似
Python 3.12.1 ('venv': venv)或Python 3.11.9 ('myenv': conda)，才表示成功 - 新开终端（
Terminal → New Terminal）后，右上角终端下拉菜单里应出现对应环境名；如果没有，说明 VS Code 没识别到该环境，需检查路径是否真实存在、权限是否正常
虚拟环境别手敲 python -m venv venv，用 VS Code 内置命令更稳
手动在终端里建虚拟环境看似简单，但容易因当前 shell 环境、Python 路径歧义、中文路径、空格或权限问题导致静默失败——而 VS Code 的 Python: Create Environment 命令内部做了路径解析和错误兜底。
- 确保是以“文件夹”形式打开项目（
File → Open Folder），不是只打开单个.py文件 - 按
Ctrl+Shift+P输入Python: Create Environment（注意不是Select Interpreter） - 类型选
Venv，解释器选你系统里已有的 Python（如Python 3.12 (System)），不要勾“从 requirements.txt 创建”除非你真有那个文件 - 创建完成后，VS Code 会自动在项目根目录生成
.venv（不是venv），并立即触发Python: Select Interpreter让你选它 - 验证是否生效：新建
test.py，写import sys; print(sys.executable)，运行后输出路径必须落在.venv文件夹内
最容易被忽略的一点：VS Code 的“运行”按钮（右上角绿色 ▶️）和调试器（F5）严格依赖你选中的解释器路径。哪怕只差一个字符，断点就变空心、变量监视为空、pip install 装到全局而不是虚拟环境里——所以每次换项目，第一件事永远是确认底部状态栏显示的解释器路径对不对，而不是急着写代码。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
