必须明确配置Python解释器、安装官方Python扩展、正确设置launch.json调试模式、精准指定linter路径。否则print不输出、import标红、断点失效、静态检查失灵。
Python解释器选不对，print()都可能不输出
VSCode不会自动猜你用哪个Python环境——它只认你明确指定的路径。没配解释器，调试、运行、语法检查全会掉链子，甚至终端里python命令能跑，但VSCode里按F5直接报ModuleNotFoundError。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 打开命令面板（
Ctrl+Shift+P或Cmd+Shift+P），输Python: Select Interpreter，选你实际用的环境（比如venv目录下的python，或miniconda3/envs/myenv/bin/python） - 别选系统自带的
/usr/bin/python3（macOS/Linux）或C:\Python39\python.exe（Windows），除非你真在用它且没装包 - 选完后看窗口右下角状态栏，应显示类似
Python 3.11.5 ('myenv': venv)——括号里带venv或conda才靠谱
没装Python扩展，import报错却找不到原因
VSCode原生不支持Python语法分析、跳转、补全。光靠文件后缀.py识别不了numpy或requests这些第三方模块，Ctrl+Click点进去是空白，import标红但运行又正常，纯属编辑器“看不见”依赖。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 必须装官方
ms-python.python扩展（搜“Python”认准Publisher是Microsoft） - 禁用其他同名但非官方的Python插件，比如
tht13.python或老版本残留，容易和ms-python.python冲突 - 装完重启VSCode，再打开一个
.py文件，等右下角出现Python Language Server is ready提示才算生效
launch.json里module和file模式混用会断点失效
调试时设了断点却不停，或者args传不进脚本，大概率是launch.json里type和module/program没对齐。比如想调试pip install mypkg安装的命令行工具，却写了"program": "mypkg/cli.py"，VSCode会当成普通脚本执行，绕过入口逻辑。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 调试已安装模块（如
pytest、black）：用"module": "pytest"，别写"program" - 调试本地脚本：用
"program": "${file}"，确保当前打开的是要调试的.py文件 - 路径含空格或中文？加引号没用，VSCode内部处理不一致，改用绝对路径+英文名最稳
Pylint/Flake8报错但代码能跑，其实是配置没生效
装了pylint或flake8，也配了"python.linting.enabled": true，但编辑器里没波浪线，或者明明import os没用却没警告——八成是python.linting.pylintArgs或python.linting.flake8Args里路径错了，或者没指定可执行文件位置。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 在设置里搜
python.linting.pylintPath，填绝对路径，比如./venv/bin/pylint（Linux/macOS）或.\venv\Scripts\pylint.exe（Windows） - 避免用
python -m pylint方式调用，VSCode有时解析参数失败 - 如果项目根目录有
.pylintrc，确认它被pylintPath所在环境能读到；否则加"--rcfile=../.pylintrc"到pylintArgs
复杂点在于：每个venv可能装不同版本的linter，而VSCode的Python扩展默认只认全局PATH里的那个。换环境不重配pylintPath，就等于开着静音模式查错。
