Visual Studio 仅支持 Windows 平台的 Python 开发，必须安装 Python 开发工作负载并正确配置 Python 解释器；Mac/Linux 用户应使用 VS Code。
Visual Studio 能开发 Python 小工具，但仅限 Windows，且必须装对工作负载和解释器——缺一不可。Mac/Linux 用户请直接转向 VS Code。
Python 工作负载必须手动勾选安装
VS 安装器默认不包含 Python 支持，哪怕你装了 Community 或 Professional 版本。打开 Visual Studio Installer 后，不能只点“修改”，必须找到并勾选 Python 开发 工作负荷。这个选项下还藏着几个关键子项：
-
Python 发行版：建议至少勾选Python 3 (64-bit)或你本地已安装的 Anaconda/Miniconda 路径；VS 会自动扫描注册表和常见路径，但不会主动下载解释器 -
Python Web 支持：做 Flask/Django 小工具才需要，纯命令行工具可不选 -
Python 本机开发工具：仅当你打算写 C 扩展（如加速计算）或调试混合代码时才启用，否则跳过
漏掉 Python 开发 工作负荷，新建项目时根本看不到 Python Application 模板，也进不了 Python 环境 窗口。
解释器未正确识别会导致 IntelliSense 失效
即使装了工作负荷，VS 仍可能找不到你的 Python。常见原因有：
立即学习“Python免费学习笔记（深入）”；
- Python 安装时没勾选
Add Python to PATH，导致 VS 在环境变量里查不到python.exe - 你用的是便携版 Python 或自定义路径安装（比如装在
D:\tools\python312\），VS 默认扫描范围不覆盖该路径 - Conda 环境未激活，或
envs目录不在 VS 的默认探测列表中
解决办法：打开 视图 > 其他窗口 > Python 环境，点击右上角 + 号，手动添加解释器路径，例如：C:\Users\name\AppData\Local\Programs\Python\Python312\python.exe 或 D:\miniconda3\envs\mytool\python.exe。添加后务必点击该环境右侧的 刷新 图标，否则 IntelliSense 数据库不会重建，补全和跳转依然失效。
调试前必须确认“启用本机代码调试”是否误开
Python 小工具通常是纯解释型脚本，不需要混合调试。但 VS 新建 Python 项目时，默认可能开启 启用本机代码调试（在项目属性 → 调试页）。一旦开启，会出现两个典型问题：
- 程序运行完立即退出，控制台不暂停，看不到
print输出 - 调试时断点偶尔不命中，或堆栈显示混乱，尤其调用
subprocess或第三方 C 扩展时
正确做法：右键项目 → 属性 → 调试 页 → 取消勾选 启用本机代码调试。如果确实需要混合调试（比如调用了自己写的 .pyd 模块），再勾选，并在 解释器参数 中加上 -i，否则控制台闪退无法排查输出。
最易被忽略的一点：VS 不支持直接运行 .py 文件（不像 VS Code 右键“Run Python File”）。你必须把文件加入项目、设为启动项，或通过 Python 环境 窗口右键该环境 → 在交互窗口中打开 来临时执行——小工具开发中，这点操作惯性差异最容易卡住新手。
