必须先通过Ctrl+Shift+P执行Python: Select Interpreter选对解释器,否则F5调试、Shift+Enter运行、Ctrl+左键跳转均失效;F5启动调试依赖launch.json配置和已选解释器,首次按F5需选择带路径的Python解释器(如./venv/bin/python)并生成有效配置。

Ctrl+Shift+P 打开命令面板,输入 Python: Select Interpreter 选对解释器,才是所有快捷键生效的前提。没选对解释器,F5 调试、Shift+Enter 运行选中代码、甚至 Ctrl+鼠标左键 跳转定义都会失效或跳到错误位置。
怎么让 F5 正常启动调试
VS Code 的 F5 不是“直接运行”,而是“启动调试会话”,必须依赖有效的 launch.json 配置和已选解释器:
- 首次按
F5,若未配置调试器,VS Code 会提示“选择环境”——此时必须点选一个带路径的 Python 解释器(如./venv/bin/python或C:\Python311\python.exe),不能选“Python”空选项 - 选完后自动生成
.vscode/launch.json,默认使用"justMyCode": true,只调试当前项目代码,跳过标准库和第三方包 - 如果想在调试时也能跳进第三方库源码(比如看
requests.get()内部),需手动把"justMyCode"改为false - 常见报错
No module named '__main__'; '__main__' is not a package,通常是因为当前文件名是__init__.py或含点号(如my.module.py),改名即可
Shift+Enter 运行选中代码总失败?检查这三点
这个快捷键把选中代码发给 Python Interactive 窗口执行,但容易卡在“找不到内核”或“输出空白”:
- 确保已安装并启用
Python扩展(非Pylance单独扩展),且右下角状态栏显示 Python 解释器路径(如Python 3.11.9) - 首次使用需等待几秒初始化 Jupyter 内核;若长期卡住,终端里运行
pip install ipykernel并重启 VS Code - 选中代码不能含语法错误(哪怕只是多一个冒号),否则整块不执行,也不报错——建议先
Ctrl+Enter运行单行验证
格式化代码的快捷键为什么没反应
Shift+Alt+F(Windows/Linux)或 Shift+Option+F(Mac)触发格式化,但前提是格式化工具已安装且被识别:
- 必须提前用
pip install black或pip install autopep8安装对应工具,仅装插件不够 - 在设置里搜
Python Formatting Provider,手动选black(推荐)或autopep8,不能留空 - 若保存时自动格式化失效,检查
Editor: Format On Save是否开启,并确认当前文件语言模式是Python(右下角状态栏显示,不是Plain Text) -
black默认不处理字符串字面量换行,若想强制 PEP 8 对齐,加参数--line-length=88到python.formatting.blackArgs设置项
自定义代码片段的触发关键词不生效
写好 python.json 后输 main 按 Tab 没反应,问题往往出在作用域或 JSON 格式上:
立即学习“Python免费学习笔记(深入)”;
-
"scope": "python"必须小写,写成"Python"或漏掉会失效 - 每个片段结尾不能有多余逗号,JSON 严格校验——VS Code 编辑器会标红提示,但新手常忽略
-
prefix只支持纯字母数字,try-catch这类含连字符的会失败,改用trycatch或tryblock - 若在工作区级配置(
.vscode/snippets/python.json),优先级高于用户级,但仅对当前文件夹生效;全局配置统一放用户级python.json
Ctrl+B 也跳不到定义。


















