python项目无需传统构建，因属解释型语言；vscode中ctrl+shift+b默认不生效，需手动配置tasks.json，设"type":"shell"、"command":"python"、"args":["${file}"]、"group":"build"方可一键运行。
VSCode 本身没有传统意义上的“构建系统”概念（比如 Make 或 CMake 那种），Python 项目也不需要编译，所以你看到的 Ctrl+Shift+B 构建命令默认不生效——这不是配置错了，是压根没这个需求。
为什么 Python 项目不需要 build task？
Python 是解释型语言，运行靠 python 或 python3 直接执行脚本或模块。所谓“构建”，在 Python 场景里通常指：
- 安装依赖（
pip install -e .或pip install .） - 打包发布（
python -m build） - 运行测试（
pytest、python -m unittest） - 格式化/类型检查（
black、mypy）
这些不是构建步骤，而是开发工作流中的独立任务。VSCode 的 tasks.json 可以封装它们，但得按需定义，不能套用 C/C++ 模板。
如何手动添加可触发的 Python 任务（如运行 main.py）
用 VSCode 的任务功能模拟“一键运行”，关键在 .vscode/tasks.json 的正确写法：
- 必须指定
"type": "shell"或"type": "process"，不能留空或写"shell"字符串（旧文档常见错误） -
"command"推荐用python而非硬编码路径（如C:\Python39\python.exe），VSCode 会自动匹配当前 Python 解释器 - 如果项目有
__main__.py，可用-m your_package方式运行，避免路径问题 - 务必加
"group": "build"才能被Ctrl+Shift+B捕获为默认构建任务
示例（运行当前文件）：
{
"version": "2.0.0",
"tasks": [
{
"label": "Run Current File",
"type": "shell",
"command": "python",
"args": ["${file}"],
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true,
"clear": true
}
}
]
}
运行 pytest / mypy 等工具时容易出错的点
这类任务失败，90% 不是配置问题，而是环境没对齐：
-
pytest报ModuleNotFoundError：没激活虚拟环境，或tasks.json没继承 VSCode 的 Python 解释器路径（加"options": {"cwd": "${workspaceFolder}"}） -
mypy不识别类型提示：确认已用pip install mypy安装，且 VSCode 的 Python 扩展没禁用类型检查 - 命令找不到（
'pytest' is not recognized）：说明 shell 没加载venv/bin/activate（Windows 是venv\Scripts\activate.bat），此时应改用"command": "${workspaceFolder}/venv/bin/python"（Linux/macOS）并把pytest作为参数传入
别把 launch.json 和 tasks.json 搞混
launch.json 控制调试（F5），tasks.json 控制终端命令（Ctrl+Shift+B）。两者可以联动，但不能互相替代：
- 想“调试时自动先跑测试”？用
preLaunchTask字段关联 task label - 想“运行某个脚本后立刻看输出”？用
tasks.json+presentation.panel: "shared"复用终端 - 误把
python -m http.server写进launch.json？会卡在调试模式，无法响应 HTTP 请求
真正麻烦的是跨平台路径和 shell 行为差异——Windows 的 cmd 不认 source venv/bin/activate，而 Linux/macOS 的 bash 不认 venv\Scripts\activate.bat。最稳的做法是绕过 activate，直接调用虚拟环境里的 python 可执行文件。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
