Python入门VS Code配置Python开发环境全攻略一、开篇轻量级但强大到离谱的编辑器上一篇文章我们讲了PyCharm它是Python开发的重型武器——功能全面但比较吃资源。今天要介绍的VS CodeVisual Studio Code走的是一条完全不同的路线。 VS Code本身是一个轻量级的代码编辑器但通过丰富的插件系统它能变成几乎任何编程语言的IDE。在Python开发领域VS Code是PyCharm最强劲的竞争对手。它有什么优势免费开源、启动飞快、插件丰富、一个月不关也不卡。如果你需要在Python、JavaScript、Go、Rust等多种语言间切换或者电脑配置不是特别高VS Code会是绝佳选择。二、VS Code和PyCharm对比在安装之前我们先搞清楚两个工具各自的定位维度VS CodePyCharm定位代码编辑器通过插件变IDE专业IDE价格完全免费社区版免费/专业版收费启动速度快2-3秒较慢10-30秒内存占用较低200-500MB较高500MB-1.5GBPython支持通过插件好内置深度支持最好多语言支持极强插件生态专注PythonGit集成很好极好数据库工具需单独插件专业版内置重构能力一般强 我的建议纯Python开发、追求开箱即用 → PyCharm多语言开发、电脑配置不高 → VS Code两个都装也行它们不冲突。很多开发者是PyCharm做主力VS Code做辅助三、下载安装VS Code3.1 官方下载✅ 唯一下载地址https://code.visualstudio.com/网站会自动匹配你的操作系统。点击那个大大的蓝色下载按钮就行。文件大小约80-100MB比PyCharm轻多了。3.2 Windows安装① 双击exe文件一路Next。② 在选择附加任务页面有几个选项建议勾选☑ 将通过Code打开操作添加到Windows资源管理器文件上下文菜单 ☑ 将通过Code打开操作添加到Windows资源管理器目录上下文菜单 ☑ 将Code注册为受支持的文件类型的编辑器 ☑ 添加到PATH重启后生效勾上添加到PATH之后你就能在命令行中使用code命令了。③ 点击安装完成后启动VS Code。3.3 Mac安装① 双击下载的.zip文件解压得到Visual Studio Code.app② 将它拖入应用程序文件夹③ 双击启动或者用Homebrewbrewinstall--caskvisual-studio-code3.4 安装中文语言包VS Code原生支持多语言。进入后① 按Ctrl Shift PMacCmd Shift P打开命令面板② 输入display language③ 选择 “Configure Display Language”④ 选择 “中文(简体)”⑤ 点击安装并重启或者直接在左侧活动栏点扩展图标或按Ctrl Shift X搜索Chinese安装 “Chinese (Simplified) Language Pack”。四、配置Python开发环境4.1 安装Python扩展这是最关键的一步。VS Code的Python能力全靠扩展提供。① 点击左侧活动栏的扩展图标或按Ctrl Shift X② 在搜索框中输入Python③ 找到微软官方发布的Python扩展发布者是Microsoft安装量上亿的那个点击安装这个扩展实际上是一个扩展包安装后自动包含Pylance快速强大的Python语言服务器代码补全、类型检查Python DebuggerPython调试器Python核心Python支持等待安装完成可能需要几十秒下载安装好后左侧活动栏会多一个Python图标。4.2 选择Python解释器安装完Python扩展后你需要告诉VS Code用哪个Python① 按Ctrl Shift P输入Python: Select Interpreter② 在列表中选择你已安装的Python版本Python 3.12.1 64-bit (Python312: pip) ← 系统Python Python 3.12.1 64-bit (myproject: venv) ← 虚拟环境中的Python Python 3.11.7 64-bit ← 另一版本③ 选择后VS Code会在当前工作区使用这个解释器。选择结果会保存到.vscode/settings.json中。 如果你有多个项目每个项目可以独立选择不同的Python解释器。4.3 创建并运行Python文件① 打开一个文件夹作为工作区文件 → 打开文件夹② 在文件资源管理器中左侧第一个图标右键 → “新建文件” → 输入hello.py③ 写一段测试代码importsysdefgreet(name):print(f你好{name})print(f当前使用的Python版本{sys.version})print(fPython安装路径{sys.executable})if__name____main__:greet(VS Code用户)④ 点击右上角的运行按钮▶三角形或按Ctrl F5。底部会弹出终端面板显示运行结果。✅ 当你在终端中看到你好VS Code用户的输出说明Python环境在VS Code中配置成功了。4.4 运行按钮在哪里VS Code提供多种运行Python脚本的方式方式操作运行按钮编辑区右上角的▶按钮右键运行编辑区右键 → “在终端中运行Python文件”快捷键Ctrl F5运行或F5调试运行选中执行选中代码 → 右键 → “在Python终端中运行选定内容”⌨️ 在Python终端中运行选定内容是一个非常棒的功能——你可以只运行选中的几行代码而不需要运行整个文件。这在调试和实验代码时特别有用。五、必装的Python辅助扩展除了微软官方的Python扩展包以下扩展能让你的开发体验更上一层楼5.1 autopep8 - 自动格式化安装autopep8扩展它根据PEP 8Python官方代码风格指南自动格式化你的代码。先通过pip安装autopep8工具pipinstallautopep8然后在VS Code的扩展市场搜索并安装autopep8或者直接在VS Code设置中指定格式化工具文件 → 首选项 → 设置搜索python formatting设置Python Formatting: Provider → autopep8配置好后右键 → “格式化文档”或Shift Alt F即可自动格式化当前文件。5.2 Black - 更严格的格式化器Black号称不妥协的代码格式化器——它不给用户提供格式化选项所有人都用统一的格式。如果你不想纠结于格式细节Black是最省心的选择。pipinstallblack在VS Code中搜索并安装Black Formatter扩展然后设置为默认格式化器。5.3 isort - 导入排序自动整理导入语句的顺序标准库→第三方库→本地模块pipinstallisort在VS Code设置中搜索isort并启用。5.4 flake8 / pylint - 代码检查安装一个代码检查工具帮你找出潜在的bug和风格问题pipinstallflake8# 或者pipinstallpylintVS Code的Python扩展会自动检测并启用它们。代码中的问题会在编辑区以波浪线标出。5.5 Jupyter扩展如果你想在VS Code中运行Jupyter Notebook.ipynb文件需要安装Jupyter扩展搜索并安装Jupyter发布者Microsoft。安装后你可以直接在VS Code中创建、编辑和运行.ipynb文件体验比网页版Jupyter还要好。5.6 Thunder Client - API测试工具如果你做Web开发或爬虫经常需要测试HTTP接口。Thunder Client是VS Code内置的轻量级API测试工具类似Postman但完全在VS Code内运行非常方便。六、VS Code的核心Python设置6.1 settings.json配置按Ctrl Shift P输入Open User Settings (JSON)打开用户级配置文件{// Python专属设置 // 默认的Python解释器路径python.defaultInterpreterPath:D:\\Python312\\python.exe,// 格式化设置editor.formatOnSave:true,// 保存时自动格式化editor.formatOnPaste:false,[python]:{editor.formatOnSave:true,editor.defaultFormatter:ms-python.autopep8,editor.tabSize:4,// Python用4空格缩进editor.insertSpaces:true,// Tab转为空格editor.rulers:[79,100]// 参考行宽线},// Python特定设置python.languageServer:Pylance,python.analysis.typeCheckingMode:basic,// 类型检查级别python.analysis.autoImportCompletions:true,// 自动导入补全python.terminal.activateEnvironment:true,// 终端自动激活虚拟环境// 通用编辑器设置 editor.fontSize:14,editor.fontFamily:Cascadia Code, JetBrains Mono, Consolas, monospace,editor.fontLigatures:true,// 连字效果(→变成箭头等)editor.renderWhitespace:boundary,// 显示空格边界editor.minimap.enabled:true,// 代码缩略图editor.bracketPairColorization.enabled:true,// 彩色括号匹配editor.guides.bracketPairs:true,// 括号对参考线// 文件设置files.autoSave:afterDelay,// 自动保存files.autoSaveDelay:1000,// 1秒后自动保存files.exclude:{**/__pycache__:true,**/*.pyc:true,**/.pytest_cache:true,**/.mypy_cache:true},// 终端设置terminal.integrated.defaultProfile.windows:PowerShell,terminal.integrated.fontSize:13}6.2 工作区设置 vs 用户设置用户设置User Settings对所有VS Code窗口生效存于%APPDATA%\Code\User\settings.json工作区设置Workspace Settings只对当前打开的项目文件夹生效存于.vscode/settings.json 建议把通用设置放在用户设置中把项目特有的设置如Python解释器路径、特定格式化规则放在工作区设置中。七、调试器配置7.1 什么是调试器调试器是你写代码时最强大的排错工具。它可以让你在代码的任意位置暂停查看当时所有变量的值然后一行一行地逐步执行代码观察数据如何变化。VS Code内置了强大的Python调试器配置简单。7.2 快速调试最简单的调试方式① 在编辑区点击代码行号左边会出现一个红点断点breakpointname小明age25# ↓ 在这行设置断点点击行号左侧greetingf{name}今年{age}岁# ← 红点print(greeting)② 按F5而不是Ctrl F5启动调试模式。③ 程序会运行到断点处暂停。此时你可以查看左侧面板中所有变量的当前值把鼠标悬停在代码中的变量上查看其值按F10单步执行执行当前行跳到下一行按F11进入函数内部调试按F5继续运行到下一个断点7.3 launch.json配置对于复杂项目你可能需要一个调试配置文件。在左侧活动栏点击运行和调试图标或按Ctrl Shift D点击创建launch.json文件选择Python。{version:0.2.0,configurations:[{name:Python: 当前文件,type:debugpy,request:launch,program:${file},console:integratedTerminal,justMyCode:true},{name:Python: main.py,type:debugpy,request:launch,program:${workspaceFolder}/main.py,console:integratedTerminal,args:[--verbose],env:{DEBUG:true}},{name:Python: Flask应用,type:debugpy,request:launch,module:flask,env:{FLASK_APP:app.py,FLASK_ENV:development},args:[run,--no-debugger,--no-reload],jinja:true}]}配置好之后你就可以在运行和调试面板中从下拉菜单选择不同的调试配置来启动特定场景的调试。7.4 调试快捷键速查操作快捷键说明启动调试F5开始调试停止调试Shift F5终止调试单步跳过F10执行当前行不进入函数内部单步进入F11进入函数内部逐行执行单步跳出Shift F11跳出当前函数继续F5继续运行到下一个断点切换断点F9在当前行设置/取消断点八、VS Code集成终端8.1 终端的基本使用VS Code底部面板中自带一个完整的终端。按Ctrl 反引号键Tab上面那个键可以快速切换终端面板的显示/隐藏。# 终端中可以直接运行Pythonpython hello.py# 安装包pipinstallrequests# 创建虚拟环境python-mvenv venv# Git操作gitstatusgitcommit-mupdate 这个终端在Windows上默认使用PowerShell在Mac/Linux上使用系统默认shell。它和你在VS Code外面打开的终端完全一样但优势在于你不必离开编辑器就能操作命令行。8.2 多终端管理VS Code支持同时打开多个终端标签页点击终端面板右上角的创建新终端点击终端标签切换到不同终端点击垃圾桶图标关闭终端一个常见的用法一个终端跑程序另一个终端操作git和安装包。九、Git集成9.1 源代码管理VS Code内置了Git图形化界面。点击左侧活动栏的源代码管理图标或按Ctrl Shift G。修改过的文件会出现在更改列表中点击文件可以查看前后对比diff视图输入提交信息后点击✓即可提交点击…可以进行推送、拉取等操作9.2 可视化的diff视图这是VS Code的一大亮点。当你修改了一个文件VS Code会在编辑区左侧的装订线显示绿色条新增的代码蓝色条修改的代码红色三角删除的代码点击装订线上的颜色条可以看到内联的对比视图非常直观。十、本篇小结✅ VS Code经过适当的插件配置完全能成为一流的Python开发环境。核心步骤回顾下载安装VS Code免费轻量80MB搞定安装Python扩展微软官方出品必装选择Python解释器CtrlShiftP→ Python: Select Interpreter必装辅助扩展autopep8/Black、isort、flake8、Jupyter配置settings.json自动格式化、类型检查、文件排除学会调试F5启动调试F10单步执行善用终端Ctrl 打开终端面板 VS Code和PyCharm没有绝对的好坏之分。选一个你看着顺眼的把它用熟就足够了。工具永远为效率服务不要陷入哪个更好的无休止争论。