VSCode写Python效率瓶颈在于光标定位、代码跳转、格式化和错误提示。Ctrl+P+@可模糊匹配跳转函数类；Ctrl+Shift+O快速导航当前文件结构；Ctrl+单击跳转需确认解释器路径、配置无误及存根支持；Black格式化须分语言指定默认formatter并注意pyproject.toml优先级。
VSCode写Python，真正卡住效率的从来不是语法，而是光标在哪、代码怎么跳、格式谁来管、错误在哪冒——这些事不解决，再多的“高级技巧”都白搭。
Ctrl+P + @ 符号：精准定位函数和类，别再滚鼠标找
在 views.py 或 models.py 这类动辄上千行的文件里，靠眼睛扫 def 或 class 名字，既慢又容易漏。用 Ctrl+P 后输入 @，会立刻列出当前文件所有可跳转符号（函数、类、方法），支持模糊匹配。
- 输入
@get_能快速筛选出get_user_by_id、get_profile等函数 - 配合方向键上下选择，回车直接跳转，比
Ctrl+F查关键词快得多 - 注意：这个功能依赖 Python 插件和 Pylance 正常工作；如果没反应，先检查右下角状态栏是否显示了正确解释器路径
Ctrl+Shift+O：打开当前文件大纲，快速导航方法块
Ctrl+Shift+O 是轻量级的“结构视图”，它不依赖语言服务器，只要语法合法就能解析出类/函数层级。适合在临时查看或网络较差时使用。
- 按完后弹出浮动窗口，直接输入名字（如
__init__）即可定位 - 对
__init__.py文件特别有用——能快速看到所有from ... import ...暴露的符号 - 和
Ctrl+P @的区别在于：前者只看当前文件，后者也支持跨文件跳转定义；但Ctrl+Shift+O响应更快，无延迟
Ctrl+单击 / F12：跳转定义失效？先查这三件事
跳不到第三方库（比如 pandas.DataFrame）或自定义模块，不是插件坏了，大概率是环境或配置没对上。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
立即学习“Python免费学习笔记（深入）”；
- 确认右下角状态栏显示的是项目虚拟环境路径，不是系统 Python —— 错选会导致 Pylance 找不到包
- 检查
settings.json中是否有误配"python.defaultInterpreterPath"，路径末尾多了一个空格或斜杠都会失败 - 某些包（如 PyTorch）含 C 扩展，Pylance 默认不索引二进制部分；可在设置中开启
"python.analysis.extraPaths"指向其site-packages下的.pyi存根目录
保存即格式化：Black Formatter + editor.formatOnSave 配合要点
装了 Black Formatter 却没生效？常见原因是格式化器被其他插件覆盖，或者语言特定配置没写对。
- 必须在
settings.json中明确指定："[python]": {"editor.defaultFormatter": "ms-python.black-formatter"} - 全局
"editor.defaultFormatter"不会自动继承到 Python，必须分语言写死 - 如果用了 Ruff 作为 linter，它默认不开 auto-fix；想保存时同时 lint 和 format，得额外配置
ruff.fixAll并设为true - Black 对
pyproject.toml敏感——若项目根目录有该文件且含[tool.black]配置，它会优先读取，忽略 VSCode 设置
最常被忽略的其实是解释器路径和 pyproject.toml 的隐式接管——这两处一错，跳转、补全、格式化全跟着偏航，修它们比重装插件管用十倍。
