vscode任务不报错也不高亮问题，根本原因是未配置problemmatcher（如"$python"），导致vscode无法解析输出中的错误行；必须匹配实际工具的输出格式，并确保命令输出标准traceback。
VSCode 本身不提供 Python 构建能力，所谓“构建”其实是调用你本地的工具链（比如 python -m py_compile、pylint、black、tox 或自定义脚本）；任务管理器只是把命令结构化封装，关键在配置能否让错误可定位、执行不卡死、环境不丢失。
为什么 python -m compileall 配成 task 后没报错但也不高亮问题
根本原因是 VSCode 默认不解析纯文本输出——它看到一堆日志，但不知道哪行是错误、该跳到哪个文件哪一行。
- 必须加
"problemMatcher": ["$python"]，这是 VSCode 内置的 Python 错误匹配规则，能识别File "xxx.py", line 5这类格式 - 如果命令本身不输出标准 traceback（比如用了
2>&1 > /dev/null），匹配器就抓不到任何东西 -
$python匹配器只对标准 Python 解释器错误有效；若用pylint或mypy，得换对应 matcher，比如"$pylint"或"$mypy"
tox 任务跑起来后终端卡住、无法编辑
这是因为 tox 默认前台运行，VSCode 等它退出才释放终端控制权；而 tox 多环境测试往往要几分钟，期间编辑器被阻塞。
- 加
"isBackground": true，告诉 VSCode：“这任务不会退出，别等它” - 同时必须配
"problemMatcher": ["$python"]或"$pytest"（取决于 tox 执行的是什么命令），否则后台模式下错误照样不显示 - 注意：后台任务启动后，VSCode 不会自动聚焦终端面板，建议加
"presentation": {"reveal": "silent"}避免干扰
Windows/macOS/Linux 上 npm run lint 能跑，但 python -m black 报 command not found
不是命令写错了，而是 VSCode 启动时没加载你的 shell 初始化文件（~/.zshrc、~/.bash_profile 或 Windows 的 PATH 注册表路径），导致找不到 black 可执行文件。
- macOS/Linux：在 VSCode 设置里打开
terminal.integrated.inheritEnv，设为true - 更稳妥的做法是绕过 shell 查找，直接用项目级二进制：
"command": "./venv/bin/black"（Linux/macOS）或"command": ".\venv\Scripts\black.exe"（Windows） - Windows 用户若用 PowerShell，有时因执行策略限制拒绝运行脚本，可临时改用
"shell": {"executable": "cmd.exe"}
真正容易被忽略的点是：VSCode 的 task 不继承 .env 文件或项目根目录下的 shell 配置，哪怕你在终端里 source venv/bin/activate 成功了，task 里还是得显式指定解释器路径或二进制位置。一个 tasks.json 文件写完，至少要验证三件事：路径是否在工作区根目录、group 是否设为 "build" 或 "test"、problemMatcher 是否匹配实际输出格式。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
