需安装Python官方扩展、Pylance语言服务器、Jedi备选补全、Ruff代码检查及Auto Import跨文件导入插件,并配置解释器路径、typeCheckingMode、ruff.toml等以实现高精度补全与稳定开发。

如果您希望在 VS Code 中搭建高效、智能的 Python 开发环境,需针对性地安装与配置核心插件、语言服务器及编辑器设置。以下是实现高精度代码补全与稳定开发体验的具体步骤:
一、安装 Python 官方扩展
该扩展由 Microsoft 官方维护,集成 Pylance 语言服务器、调试器、测试框架支持及基础语法高亮,是代码补全能力的底层支撑。
1、打开 VS Code,点击左侧活动栏中的扩展图标(或按 Ctrl+Shift+X)。
2、在搜索框中输入 Python,找到发布者为 Microsoft 的官方扩展。
立即学习“Python免费学习笔记(深入)”;
3、点击“安装”,安装完成后重启 VS Code 或重新加载窗口。
二、启用并配置 Pylance 作为默认语言服务器
Pylance 提供基于类型推断的深度补全、符号跳转与实时错误检测,其性能与准确率显著优于默认的 Jedi。
1、按下 Ctrl+, 打开设置界面,在搜索栏输入 python.defaultInterpreterPath,确保已正确指向本地 Python 解释器路径。
2、在设置中搜索 python.languageServer,将其值设为 Pylance。
3、在用户设置 JSON(Ctrl+Shift+P → “Preferences: Open Settings (JSON)”)中添加以下行:
"python.analysis.typeCheckingMode": "basic",
"python.analysis.autoSearchPaths": true,
"python.analysis.extraPaths": ["./src", "./lib"]
三、安装 Jedi 插件作为补全备选方案
当 Pylance 在特定动态场景(如 getattr、__getattr__)下补全失效时,Jedi 可提供基于 AST 的回退式补全支持。
1、再次进入扩展市场,搜索 Jedi,安装由 David M. N. Brown 发布的 Jedi 插件。
2、在设置中搜索 python.jediEnabled,勾选启用选项。
3、重启 VS Code,此时编辑器将在 Pylance 不响应时自动降级调用 Jedi 补全引擎。
四、配置 Ruff 插件实现即时语法与风格提示
Ruff 提供毫秒级 linting 与自动修复,其输出可被 Pylance 解析并转化为内联补全建议(如未导入模块的自动 import 补全)。
1、在终端中执行 pip install ruff 安装命令行工具。
2、安装扩展市场中的 Ruff 插件(发布者:Charalampos Karypidis)。
3、在工作区根目录创建 ruff.toml,写入:
select = ["E", "F", "I", "C4", "B007"]
fixable = ["ALL"]
line-length = 88
五、安装 Auto Import 插件增强跨文件符号补全
该插件监听编辑行为,在键入未声明变量名时,自动扫描项目内所有 Python 文件,生成带 from/import 的补全项。
1、在扩展市场搜索 Auto Import,安装由 steoates 发布的版本。
2、在设置中搜索 auto-import,启用 Auto Import: Auto Import 和 Auto Import: Show Suggestions。
3、在用户设置 JSON 中添加:
"auto-import.showSuggestions": true,
"auto-import.importStyle": "from"

















