编辑器与周边:配好你的 VS Code 开发驾驶舱

系列说明:这是「新生开发环境搭建」系列的最后一篇。前三篇装好了 Scoop、Python(uv)和 Git,这一篇把驾驶舱配好——之后你写代码的每一天都会在这片仪表盘前度过。

一、为什么是 VS Code

写 Python 的编辑器选择很多:PyCharm 功能全但体格庞大,开一次吃掉半个 G 内存,机房老电脑跑得直喘气;记事本能用但等于徒手搬砖。VS Code 卡在中间的最优解:启动快、内存省、插件生态齐全,微软官方维护,对 Python 的支持是所有轻量编辑器里最完善的。

它还有个对初学者隐藏的加分项:内置终端。写代码、跑代码、敲 Git 命令,全在一个窗口里完成——前三篇学的 uv rungit push 不用切出去另开 PowerShell,编辑器里直接敲。

第 1 篇已经装好了它(scoop install vscode),开始菜单里找到 VS Code 打开即可。

🎓 讲师提示:若学生没走第 1 篇,scoop install vscode 一条命令补上。打开后右键任务栏图标选「固定到任务栏」,这将是他们未来四年的常用软件。

二、装三个插件,Python 开发就位

VS Code 本体只是个壳,语言支持靠插件。左侧竖排图标里点四个方块的那个(扩展,快捷键 Ctrl+Shift+X),搜索并安装:

插件作用备注
Python(微软官方)语法高亮、代码补全、调试、运行搜索结果认准发布者 Microsoft
Pylance(微软官方)更快的补全和类型检查装 Python 插件时通常自动带上
Chinese (Simplified)界面中文化装完右下角弹提示,点 Restart

装完 Python 插件,左下角观察状态栏——它会显示当前 Python 解释器的版本号。这个版本号很重要,下一节就讲它。

🎓 讲师提示:机房网络若访问插件市场慢,属于 VS Code 官方源问题,一般不卡;真卡了换手机热点。中文化插件建议装,降低大一学生的界面焦虑。

三、关键一步:把解释器指向项目的虚拟环境

装好插件,VS Code 还不知道你的项目该用哪个 Python——还记得第 2 篇吗?每个项目有自己的虚拟环境(.venv 目录),VS Code 必须被告知。

操作流程:用 VS Code 打开你的项目文件夹(文件 → 打开文件夹,选 hello-ml,就是第 2 篇建的那个),按 Ctrl+Shift+P 唤出命令面板——VS Code 的一切功能入口,记不住快捷键就背这一个——输入 interpreter,选「Python: 选择解释器」,在列表里选带 .venv 字样的那一项。

选对之后会发生三件立竿见影的事:

  1. 左下角状态栏显示 .venv 里的 Python 版本
  2. import requests 不再报黄色波浪线——补全知道这个库的存在了
  3. 点右上角的「运行」按钮(三角形),等同于执行 uv run,代码跑在正确的环境里

换项目时重复一次这个动作。VS Code 会记住每个项目的选择,之后一劳永逸。如果你发现「补全全飘黄、运行报 ModuleNotFoundError」,九成是解释器没选对,回到命令面板重来。

🎓 讲师提示:这一节是本篇最容易卡住的地方,学生列表里可能找不到 .venv 项——通常是没打开项目文件夹本身(打开了上层目录),或者项目还没跑过 uv add(环境不存在)。这两个原因讲透。

四、界面配置:看得清,才写得顺

VS Code 的设置全部集中在 文件 → 首选项 → 设置(快捷键 Ctrl+,),图形界面加搜索框,改完即时生效。三个对新手收益最大的配置:

自动保存:搜索 files.auto save,选 afterDelay。从此告别「改了代码忘保存,运行的还是旧版」的灵异事件。

字体大小:搜索 font size,设为 14~16。投影演示或日后接外接屏时按需再调,字号是生产力。

显示空格与缩进:搜索 render whitespace,选 boundary。Python 用缩进划分代码块,空格混入 Tab 是经典报错来源,让它们现出原形能防患于未然。

另外两处「顺手」的界面开关值得现场演示:左侧资源管理器(Ctrl+Shift+E)集成着源代码管理面板——第 3 篇装的 Git 在这里有图形界面,改过的文件以颜色标注,点一下就能暂存和提交,和命令行殊途同归;右侧的迷你地图(minimap)给出全文件的鸟瞰,长文件导航靠它。

🎓 讲师提示:源代码管理面板演示一次「图形化 commit」,然后强调:面板和命令行做的是同一件事,命令行是通用技能(服务器上没有图形界面),面板是效率工具,两者都会。

五、字体与主题:两个值得早点定下来的小决定

字体:写代码的字体和普通文档字体不是一回事,等宽是底线——il1 必须长得不一样,0O 必须分得清,否则你会在排查 bug 时把时间浪费在辨认字符上。推荐两款都免费的开源字体:JetBrains Mono(JetBrains 出品,字形舒展)或 Cascadia Code(微软出品,Windows 自带手感)。装好后到设置里搜 font family,填入字体名即可。Scoop 用户有更顺的路:scoop bucket add nerd-fontsscoop install JetBrainsMono-NF

主题:深色护眼、浅色亮堂,纯个人偏好,但对比度要够——花哨的「赛博朋克」主题写两小时代码眼睛就废了。默认的 Dark+Light+ 已经足够好,想换的话扩展市场搜 theme,装完 Ctrl+K Ctrl+T 实时预览切换。

这两件事没有标准答案,但建议大一就定下来不再折腾——肌肉记忆都长在固定一套界面配置上,频繁换主题换字体的收益趋近于零。

六、周边工具:值得认识的两位邻居

最后介绍两个不属于本系列主线、但和这套工作流天然契合的工具。

Typora / Obsidian:记课程笔记的两条路。Typora 是买断制的极简 Markdown 编辑器,所见即所得;Obsidian 免费且更强大,笔记之间能互相链接,知识网络会随时间自己生长。课程笔记用 Markdown 写(VS Code 也能直接写),期末复习时检索和重组的效率远超 Word。

Windows Terminal:微软官方的现代终端,比默认的 PowerShell 窗口好用——多标签页、分屏、更好的字体渲染。Scoop 一条命令装上:scoop install microsoft-windows-terminal,装完在「设置 → 启动 → 默认终端应用程序」里把它设为系统默认,以后所有终端窗口自动升级。

工具永远在迭代,今天的推荐五年后未必成立,但选型思路不变:免费或开源、社区活跃、能被 Scoop 这类包管理器统一管理。认思路不认具体软件,这才是这篇真正想教的东西。

🎓 讲师提示:这两位邻居点到即止,别喧宾夺主。Obsidian 对爱整理的学生有奇效,可以提一句协会仓库里有现成的使用指南。

七、常见翻车现场与自救

运行按钮点了没反应:检查解释器是否选中(左下角版本号),.py 文件是否处于激活的编辑器标签页。

补全飘黄线但代码能跑:解释器没指向 .venv,第三节的方法重选一次。

插件搜不到或装不上:网络问题,重试或换网络;确认登录了微软账号(部分插件市场功能需要)。

设置改乱了想重来:设置界面每项右侧有齿轮图标,点「重置设置」恢复单项默认值——VS Code 的所有配置都是可逆的,放心点。

终端里敲 uvgit 提示找不到:VS Code 的内置终端是在打开时快照环境变量的,装完新工具重启 VS Code 即可。

八、写在最后:四篇连起来看

四篇走完,回头看这条完整的链路:

Scoop 让工具的安装、更新、卸载变成一条命令;uv 让 Python 项目之间互不干扰、依赖精确可复现;Git 与 Gitee 让代码有历史、有云端、能协作;VS Code 把这一切收进同一个窗口。四层各司其职,凑成一套大一就能用、大四还在用的环境。

更重要的是这套环境传递的方法论:工具的变化是常态,管理工具的方式才是不变的。包管理器、虚拟环境、版本控制、镜像源——这些概念你会在 Linux 服务器、Docker 容器、各种云工具里一次次重逢。今天在 Windows 上建立的直觉,就是明天迁移到任何平台的本钱。

环境已就位,剩下的路就是写代码本身了。去把你的第一个项目跑起来吧。