拓十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

VS Code 安装与配置全攻略:从下载到插件、环境搭建与常见坑

VS Code 安装与配置全攻略:从下载到插件、环境搭建与常见坑

1. 为什么这么多人都在问 VS Code 安装和配置

Visual Studio Code(以下简称 VS Code)几乎成了我这些年向别人推荐次数最多的编辑器,没有之一。不管你是刚接触编程的学生,还是写了十几年代码的老手,只要聊到"用什么写代码",话题大概率会绕到 VS Code 上。这段时间看到不少人在搜"VS Code 安装和配置""VS Code 与 VS Code 区别""CLion 安装和配置""从零开始 Hadoop 安装和配置",甚至还有"C 语言环境配置""Python 环境配置"之类的问题,我挺有感触的——很多人的困惑其实不在编辑器本身,而是"装完之后到底该怎么配"。

VS Code 是什么?简单说,它是一个免费、开源、跨平台的代码编辑器,由微软出品,支持 Windows、macOS 和 Linux 三大系统。它能干什么?写 Python、C/C++、JavaScript、Java、Go、PHP、SQL,写 Markdown 文档、改配置文件、做前端页面调试,甚至配合远程插件直接编辑服务器上的代码。它能解决什么问题?最核心的一条:让你用一套工具覆盖日常绝大多数开发场景,不用在多个编辑器之间来回切换。适合谁来学?适合所有正在折腾环境、准备入坑编程、或者想从其他编辑器迁移过来的人。

我见过太多人卡在第一步:下载倒是下载了,装完打开一看全是英文界面,然后不知道要装什么插件,不知道怎么写第一行代码,更不知道怎么配 C/C++ 编译环境、怎么让 Python 跑起来。这篇文章我就从零开始,把 VS Code 的下载、安装、配置、汉化、插件安装、运行代码、常见坑一次讲清楚,全部基于我自己反复操作过、踩过坑之后沉淀下来的方案,你照着做基本能顺利跑通。

2. 工具选型解析:为什么选 VS Code 而不是其他编辑器

2.1 VS Code、VS 和 CLion 到底怎么选

先说一个被问烂了但其实很基础的问题:Visual Studio Code 和 Visual Studio 有什么区别?我每次看到有人把这两个搞混,都想多说两句。Visual Studio 是微软推出的重量级集成开发环境(IDE),主要面向 Windows 平台,用来做 C#、.NET、C++ 等大型项目开发,安装包动辄几个 GB,启动慢、功能全。VS Code 则是一个轻量级编辑器,安装包通常几十 MB,启动快、插件生态丰富,适合各种语言的日常开发。

CLion 是 JetBrains 家的 C/C++ IDE,功能强大、对 CMake 支持好,但它是收费软件,而且同样比较重。如果你专门搞 C/C++ 大型工程,用 CLion 很舒服;但如果你是学生、刚入门,或者想找一个通用工具覆盖多语言场景,VS Code 的性价比明显更高——毕竟它免费、轻量、插件多,配上合适的插件后写 C/C++ 一样能调试、能补全。

学习计算机视觉或者 Python 开发时,另外一个常见纠结是:VS Code 和 PyCharm 到底该装哪个?我的建议是:如果你主要在学 Python,PyCharm 的社区版也可以用,但 VS Code 的启动速度、跨语言能力、远程开发能力都更占优势,而且你以后写前端、写脚本、改配置都能用同一个工具。先用 VS Code 把 Python 跑起来,后面真的碰到大型 Python 工程项目需要专业 IDE 的时候再换也不迟。

2.2 哪些场景最适合用 VS Code

从我自己的使用经验来看,VS Code 在下面这些场景里表现最好:

  • 写 Python 脚本、做数据处理、跑机器学习小实验,配好 Python 插件后非常顺手。
  • 写 C/C++ 课程作业或小项目,配合 MinGW 或 GCC 就能实现编译和调试。
  • 开发前端页面,写 HTML、CSS、JavaScript,内置的智能提示和调试功能很够用。
  • 写 Markdown 文档、博客、技术笔记,配合插件可以实时预览。
  • 远程连接服务器改代码,用 Remote-SSH 插件能像编辑本地文件一样操作服务器上的代码。
  • 做 PHP 编辑,配个 PHP 插件后语法高亮、代码补全都不错。

上面这些场景我自己都实测过,尤其在远程开发这块,VS Code 的体验在同级别编辑器里算是数一数二的。这也是我后期越来越依赖 VS Code 的根本原因——它不只是一个本地编辑器,更像是一个"客户端",把你需要的工具链都串在一起。

3. 安装前准备:版本选择和各平台下载方法

3.1 稳定版还是 Insider 版:装哪个最靠谱

进入 VS Code 官网下载页的时候,你会发现有 Stable(稳定版)和 Insider(内测版)两个选项。如果你不是想提前体验新功能,千万别碰 Insider,那个版本号称"天天更新",我早年试过一次,今天装完明天就提示更新,偶尔还会遇到莫名其妙的 bug,写代码写到一半编辑器崩溃的滋味真的不好受。老老实实选 Stable 稳定版,功能稳定、插件兼容性好,日常使用完全够用。

这里还要提醒一句:官网地址就是code.visualstudio.com,认准这一个就行。我见过有人在搜索引擎里点进第三方下载站,下载下来一个带捆绑软件的安装包,装完浏览器主页被改得乱七八糟,后悔都来不及。别贪图"高速下载"之类的按钮,就从官网下载,安全第一。

3.2 Windows 系统安装流程

在官网点击下载 Windows 版本的安装包,文件名一般是VSCodeUserSetup-x64-版本号.exe,双击运行即可。安装向导里有几个选项需要特别留意:

  1. 选中"添加到 PATH"(Add to PATH),这样你就能在终端里直接用code命令打开 VS Code。
  2. 选中"将'通过 Code 打开'操作添加到文件和目录上下文菜单",这样你在文件夹上右键就能直接打开 VS Code,非常方便。
  3. 其他选项像"创建桌面快捷方式"、"在 PATH 中添加"、"注册为 .txt 等文件的默认编辑器",可以根据个人习惯勾选。

安装完成后,打开 VS Code,如果能看到欢迎页,说明安装成功了。这时候你按Ctrl + Shift + P打开命令面板,输入code,如果能出现命令提示,就说明 PATH 配置成功。

3.3 macOS 和 Linux 系统的安装方式

macOS 用户直接下载 dmg 文件,打开后把 Visual Studio Code 拖到 Applications 文件夹即可。第一次打开如果提示"无法验证开发者",需要去"系统偏好设置 - 安全性与隐私"里允许来自 App Store 和被认可的开发者。

Linux 用户稍微折腾一点。Ubuntu 等基于 Debian 的系统,可以下载 .deb 安装包后用sudo dpkg -i安装;也可以使用 Snap 安装,命令是sudo snap install code --classic。说到这个 Snap 版本,我还真踩过坑:某次在 Ubuntu 24.04 上用 Snap 装 VS Code,安装本身没问题,但用终端启动的时候偶尔会报一个snap相关的错误,而且中文输入法在某些版本下有兼容问题。后面我换成下载 .deb 包安装,问题就少了。所以我的建议是:Linux 上优先用 .deb 包,别图省事直接 snap,尤其是你在折腾中文输入法的时候。

3.4 安装过程中的三个关键点

不管在哪个平台,安装时都要记住三点:

  • 安装路径不要放在有中文或空格的目录里,这会导致某些插件找不到路径。
  • 首次启动如果提示"正在加载工作区..."卡住,先别急着重装,多半是网络问题导致扩展下载失败,等一下或检查网络即可。
  • 安装完成后建议先设置同步(Settings Sync),登录微软或 GitHub 账号后,插件和配置可以跨机器同步,这样换电脑不用重新折腾。

4. 核心细节与实操要点:界面、汉化与插件体系

4.1 中文语言包的安装方法和注意事项

VS Code 默认是英文界面,很多人装完第一反应是"怎么全英文"。别慌,装一个中文语言包就行。在左侧边栏点击扩展图标(或者按Ctrl + Shift + X),搜索 "Chinese",会看到 "Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code",点击 Install 安装,安装完成后右下角会提示重启,重启后界面就变成中文了。

这里有个细节我得说下:重启后如果没变成中文,可以按Ctrl + Shift + P,输入display language,选择 "Configure Display Language",然后把locale改成zh-cn,保存后重新加载窗口即可。这个问题在部分网络环境或旧版本上会出现,原因多半是语言包没完全生效,这样手动设置一次就能解决。

4.2 十大必备插件:新手进阶都够用

插件是 VS Code 的灵魂。我根据自己的日常使用,把最常用的插件分成几类,你照着装基本不会错。

中文相关:

  • Chinese (Simplified) Language Pack:中文界面必备。

通用语言支持:

  • Python:提供语法高亮、智能补全、调试、运行支持,装完这个写 Python 基本够用。
  • C/C++:微软官方出的 C/C++ 插件,支持语法高亮、代码补全、调试,写 C/C++ 必装。
  • ESLint:写 JavaScript/TypeScript 时检查代码规范。
  • Prettier:代码格式化工具,配合 ESLint 使用效果极佳。

效率工具:

  • Live Server:在本地启动一个 Web 服务器,写 HTML/CSS 时实时刷新浏览器。
  • Remote-SSH:远程连接服务器,编辑服务器上的代码像操作本地文件一样。
  • GitLens:加强 Git 功能,可以看到每行代码的提交记录。
  • Todo Tree:把代码里写的 TODO、FIXME 注释列出来,方便管理待办事项。

主题美化:

  • Material Icon Theme:给各种文件显示对应的图标,找文件时一目了然。
  • One Dark Pro:经典配色主题之一,护眼又好看。

装完这些插件后,VS Code 才算真正"开光了"。我自己的习惯是:尽量少装插件,装了的就常用,避免插件太多拖慢启动速度。特别是你电脑配置一般的话,装了太多无用插件,启动时间从 1 秒变 5 秒,得不偿失。

4.3 基础界面布局:左中右都是干什么用的

装完插件、做完汉化,接下来要熟悉界面布局。VS Code 的界面主要分成这几块:

  • 左侧活动栏:依次是资源管理器(文件列表)、搜索、源代码管理(Git)、运行和调试、扩展。
  • 中间编辑器区:你打开文件、写代码的主要区域,支持多标签页。
  • 底部面板区:包括终端、输出、调试控制台、问题面板。按Ctrl + ~可以快速打开集成终端。
  • 右侧缩略图:可以看到整个文件的代码概览,点击可以快速跳转到对应位置。

我说实话,对新手来说最需要先记住的就是三个快捷键:Ctrl + Shift + X打开扩展商店,Ctrl + Shift + P打开命令面板,Ctrl + ~打开终端。这三个操作能覆盖你 80% 的日常操作。

4.4 常用快捷键:提升编码速度的关键

VS Code 里的快捷键非常多,我不建议你一开始就死记硬背全部,先记这几个最有用的:

  • Ctrl + P:快速打开文件,输入文件名就能跳到对应文件。
  • Ctrl + Shift + F:全局搜索,在新项目里找代码片段时极其方便。
  • Ctrl + /:单行注释切换。
  • Shift + Alt + F:格式化当前文件,代码乱成一锅粥的时候按一下瞬间整齐。
  • Ctrl +~``:打开/关闭集成终端。

掌握这几个快捷键以后,日常写代码的效率会有明显提升。我自己用 VS Code 这么多年,单手操作文件切换、搜索、运行已经成习惯了,这些快捷键基本已经刻进了肌肉记忆。

5. 实操过程:从零配置一套能运行的开发环境

5.1 配置 Python 环境:从安装到跑出第一个程序

Python 这块可能是全网问得最多的问题,也是我自己被问得最多的。先说一个核心认知:VS Code 本身只是一个编辑器,它不像 PyCharm 那样自带解释器。你想在 VS Code 里跑 Python,得先装 Python 解释器,再装 VS Code 的 Python 插件,然后告诉 VS Code 用哪个解释器。就这么三步。

第一步:安装 Python

Windows 用户去 Python 官网下载安装包,安装时一定要勾选"Add Python to PATH",不勾的话后面终端里输入python会提示找不到命令。macOS 用户如果不想折腾,建议直接从官网下载安装包;Linux 用户一般自带 Python,但版本可能偏低,想升级的话用sudo apt install python3或系统对应的包管理器。

装完验证一下:打开终端,输入python --version,如果能显示Python 3.x.x,说明安装成功。有些 Windows 用户输入python会直接打开微软商店,这是因为系统启用了应用执行别名,可以去"设置 - 应用 - 高级应用设置 - 应用执行别名"里关掉,或者直接用py --version命令替代。

第二步:安装 Python 插件

打开 VS Code,在扩展商店搜索Python,安装微软官方发布的那个(发布者显示为 Microsoft)。这个插件集成了语法高亮、智能补全、代码检查、调试等能力,装完就够日常用了。

第三步:选择解释器

按Ctrl + Shift + P打开命令面板,输入Python: Select Interpreter,然后从列表中选择你刚才安装的 Python 版本。这一步非常重要,如果你装了多个 Python 版本(比如 Python 3.9 和 Python 3.11),选错解释器会导致你运行的代码和安装的依赖不在同一个环境里。

第四步:写代码、运行

新建一个test.py文件,输入:

print("Hello, VS Code!")

按F5键,或者点击右上角的三角形运行按钮,如果下方终端或 OUTPUT 面板里输出了Hello, VS Code!,说明环境配置成功。需要注意的是,运行前最好在集成终端里安装必要的第三方库,比如:

pip install numpy pandas matplotlib

安装好之后,再配合 Python 插件的智能提示,写数据分析代码会非常丝滑。

5.2 配置 C/C++ 环境:MinGW 安装与调试实战

接着来说更让新手头疼的 C/C++ 环境配置。我自己在大学时就是被这个坑折磨过的人,后来带了不少学弟学妹趟过一遍,现在把最稳妥的方案写在这里。

第一步:下载安装 MinGW-w64

C/C++ 不像 Python,它没有自带的解释器,需要编译器才能把源码变成可执行文件。Windows 上最常用的编译器套件就是 MinGW-w64。可以去 MinGW-w64 的官网或 GitHub Release 页面下载安装版,也可以用 WinLibs 这类预编译包。下载解压后,把bin目录的路径添加到系统环境变量 PATH 中。

验证方法:新开一个终端,输入gcc --version,如果能显示版本号,说明编译器安装成功。如果提示"gcc 不是内部或外部命令",说明 PATH 没配置对。

注意:这里的"终端"必须是新打开的,因为环境变量修改后,已经打开的终端不会自动刷新。

第二步:安装 C/C++ 插件

在 VS Code 扩展商店搜索C/C++,安装微软官方发布的那个。这个插件会提供语法高亮、跳转定义、智能补全和调试支持。装完后编写 C 代码时会有提示,比如你输入#include <stdio.h>,插件会自动提供printf等函数提示。

第三步:配置编译任务

在 VS Code 中打开一个文件夹,新建hello.c,写最简单的代码:

#include <stdio.h> int main(void) { printf("Hello, C!\n"); return 0; }

按Ctrl + Shift + P,输入Tasks: Configure Default Build Task,选择gcc,这时候 VS Code 会自动生成一个.vscode/tasks.json文件,内容类似:

{ "version": "2.0.0", "tasks": [ { "type": "cppbuild", "label": "C/C++: gcc 生成活动文件", "command": "/path/to/gcc", "args": [ "-fdiagnostics-color=always", "-g", "${file}", "-o", "${fileDirname}/${fileBasenameNoExtension}.exe" ], "options": { "cwd": "${fileDirname}" }, "problemMatcher": [ "$gcc" ], "group": { "kind": "build", "isDefault": true }, "detail": "调试器生成的任务。" } ] }

command的路径要改成你实际的 gcc 路径。Windows 上一般是C:\mingw64\bin\gcc.exe之类的,具体取决于你安装的位置。

第四步:按快捷键编译运行

按Ctrl + Shift + B执行编译任务,如果代码没有语法错误,会在当前目录生成一个.exe文件。再在终端里执行:

./hello.exe

或者直接按F5进行调试,VS Code 会弹出选择环境,选C/C++后会自动生成launch.json。这里有个常见坑:如果调试时提示 "Unable to start debugging" 或者找不到 gdb,多半是launch.json里的miDebuggerPath没有指向 gdb 的实际路径,改成你的 gdb 路径即可。

5.3 配置远程开发:用 Remote-SSH 连服务器

现代开发中,远程开发的需求越来越常见。我经常需要在服务器上改代码、跑程序,以前都是用 Vim 硬刚,后来装了 Remote-SSH 插件后,体验直接起飞——本地 VS Code 连接远程服务器,打开远程文件夹,编辑、调试、终端一应俱全,感觉就像在本地写代码。

安装 Remote-SSH 插件后,按F1,输入Remote-SSH: Connect to Host,选择 SSH 目标后输入密码或使用密钥认证。连接成功后,左下角会出现"SSH"标识,这时候你在 VS Code 里打开的就是远程机器上的文件。远程机器也需要联网,VS Code 会在远程机器上自动安装一个 server 端,整个过程对用户基本透明。

远程开发特别适合这么几类场景:处理大文件时不受本机性能限制、跑深度学习训练时直接在服务器上看日志、修改服务器上的配置文件不用再切到 Vim。如果你工作里经常碰服务器,这个插件一定要装,它真的能改变你的开发习惯。我自己用了两年多,从"连服务器全靠记事本改配置"变成"在 VS Code 里远程改代码一点违和感都没有",效率提升非常明显。

5.4 配置 PHP 环境和 Markdown 预览

说两个相对轻量的场景。第一个是 PHP。PHP 和 Python 类似,需要先安装 PHP 解释器,然后 VS Code 装一个 PHP 插件就能实现语法高亮和代码补全。Windows 上去 PHP 官网下载压缩包,解压后把含php.exe的目录加入 PATH;装完验证php -v。VS Code 扩展里搜PHP IntelliSense,安装后 PHP 代码提示就有了。如果你只是做简单页面开发,VS Code 完全可以胜任;如果做大型 PHP 项目,大部分人可能会选 PHPStorm,但日常小项目 VS Code 绝对够用。

第二个是 Markdown。VS Code 自带 Markdown 预览功能,打开一个.md文件,按Ctrl + Shift + V就能在右侧实时预览渲染效果。配合Markdown All in One插件,还能自动生成目录、快速插入表格、管理列表缩进,写博客和技术文档非常方便。我写技术文章、学习笔记、README 都是直接用 VS Code 搞定,导出成 HTML 或 PDF 也有相应插件支持。

6. 常见问题与排查技巧实录

6.1 终端中文乱码怎么办

这个问题非常常见,尤其是 C/C++ 程序在 Windows 终端输出中文的时候。终端显示的是 UTF-8 编码,但 Windows 下的控制台默认是 GBK 编码,两者对不上就会出现乱码。解决办法有两个方向:

  • 在 VS Code 左下角点击齿轮图标,进入设置,搜索terminal.integrated.profiles.windows,把默认终端配置文件改成Command Prompt或PowerShell,然后在launch.json或终端设置里调整编码。
  • 更直接的方法是在代码里调用系统 API 设置控制台编码为 UTF-8。C 语言可以加:
#include <windows.h> SetConsoleOutputCP(CP_UTF8);

Python 的话,在文件开头加# -*- coding: utf-8 -*-,或者设置PYTHONIOENCODING=utf-8环境变量。说实话,这个问题我实测过很多次,最稳的方案还是在程序里或 VS Code 设置里统一 UTF-8 编码。

6.2 "无法在 PATH 中找到运行中的某个程序"类错误

这个问题的典型场景是:你打开了 VS Code,按Ctrl + Shift + B或运行按钮,结果提示找不到编译器。原因多半是环境变量没生效,或者 VS Code 是在环境变量修改之前启动的。解决办法也很简单:完全关闭 VS Code,重新打开,让 VS Code 重新读取 PATH。如果还是不行,检查一下编译器路径是否真的在 PATH 中:

echo %PATH%

Windows 上在 CMD 里用这个命令查看当前 PATH。如果你发现路径不对,就手动打开"系统属性 - 环境变量"重新配置,然后重开 VS Code。

6.3 插件安装失败或下载速度慢

很多人在国内网络环境下安装插件时会遇到下载慢甚至超时的情况。这个问题可以从两个角度处理:

  • 如果公司或学校网络有特殊限制,建议在 VS Code 里使用代理设置:Ctrl + ,打开设置,搜索http.proxy,填入你的代理地址。
  • 如果只是 VS Code 扩展市场源的问题,可以尝试把这个源切换到国内镜像。不过要注意,这类镜像服务并非官方长期承诺,稳定性存在波动。因此我更推荐的做法是:保持默认官网源,利用系统级代理或切换网络时段来解决。如果你在公司网络环境下,可以联系网管确认是否有相关访问策略。

6.4 VS Code 打开文件夹卡顿

如果你打开一个包含大量文件(比如node_modules)的文件夹,VS Code 可能会卡顿。这时候在设置里搜索files.exclude,把node_modules、dist、.git等不需要显示的目录加入排除列表,VS Code 就不再去索引它们了,打开速度会快不少。另外,如果你的项目本身很大,也可以搜索search.exclude和files.watcherExclude,把一些不常用的目录排除掉,减少文件监听开销。

6.5 VS Code 更新后插件失效

某次 VS Code 大版本升级后,个别插件可能会出现兼容性问题。遇到这种情况,先确认插件是否有新版本,有就更新;没有的话,到插件详情页看它支持的 VS Code 版本范围,一般过几天插件官方就会跟进兼容。如果特别着急,也可以暂时回退到上一个 VS Code 版本,但我不建议长期停留老版本,因为新版本通常会修复旧版的安全问题和 bug。

6.6 远程连接服务器经常断开

Remote-SSH 使用过程中最常见的坑就是"连接一段时间后自动断开"。这个问题的常见原因有:

  • SSH 连接空闲超时,服务器端断开了空闲连接。解决方法是在 SSH 配置里加ServerAliveInterval 60和ServerAliveCountMax 3,让客户端定期发心跳包保活。
  • 网络波动导致连接中断,建议使用密钥认证代替密码认证,这样重连时不用反复输密码。
  • 服务器端防火墙或者.ssh/authorized_keys权限不对,也会导致连接失败。记得把authorized_keys权限设置为600。

这些方法我都实际验证过,加了心跳包之后,我耳机连着服务器跑实验好几天都不中断,体验好了不是一星半点。

7. 高级配置与扩展:让 VS Code 真正变成你的开发主战场

7.1 保留字、主题、字体:打造舒适写码环境

VS Code 的个性化配置是很容易让人上头的一个点。除了换主题、装图标插件,字体选择对长时间写代码的人影响也很大。我自己默认用的是Cascadia Code或Fira Code,这类等宽字体支持连字(Ligatures),比如输入!=时会显示成更紧凑的符号,视觉上舒服很多。去settings.json里配置:

{ "editor.fontFamily": "Cascadia Code, Consolas, 'Courier New', monospace", "editor.fontSize": 16, "editor.lineHeight": 1.8, "editor.fontLigatures": true }

这里我特别想提醒:字体渲染和缩放跟屏幕分辨率、系统 DPI 有关,别只看网上的推荐值,自己调一调,找到盯着看一整天眼睛不累的配置才是正解。

7.2 自定义代码片段:少写重复代码

写代码时总有一些固定句式,比如 C 语言的#include <stdio.h>加main函数框架,或者 Python 的文件头注释。VS Code 支持自定义代码片段,按Ctrl + Shift + P输入Snippets: Configure User Snippets,选对应语言后编辑 JSON 即可。以 C 语言为例:

{ "printf debug": { "scope": "c", "prefix": "dbg", "body": [ "printf(\"DEBUG: %s\\n\", \"$1\");", "$2" ], "description": "Insert printf debug" } }

保存后,在.c文件里输入dbg,再按 Tab,就能自动展开成调试代码。这个技巧对新手特别友好,能帮你少打很多重复代码。

7.3 Git 集成与常用操作

VS Code 左侧的源代码管理面板就是图形化的 Git 工具。初始化仓库、暂存改动、提交、推送、拉取,这些常见操作都能在这里完成。我平时最常用的流程是:

  1. 修改代码后,看到M标记,点击加号暂存。
  2. 在消息框里写 commit 信息,勾选 "Commit"。
  3. 点击...菜单里的 "推送"(Push),把代码推到远程仓库。

这个流程对新手来说比命令行 Git 友好得多,而且不容易出错。配上 GitLens 插件后,还能直接看到每行代码是哪个提交引入的,排查历史问题很方便。

8. 与 Python 环境配置相关的独立心得

写完上面这些,我还想单独聊一下 Python 环境配置这件事,因为无数人来问过"为什么我的 VS Code 运行不了 Python"。绝大多数情况都是栽在"路径"和"解释器选择"上。有几个建议送给你:

  • 不要在系统自带的 Python 上直接装一堆包,建议用虚拟环境或 Anaconda 管理项目依赖。在 VS Code 里选解释器时,直接选你创建好的虚拟环境即可。
  • 每次新建项目,先开终端创建虚拟环境,比如:
python -m venv venv

在 Windows 上激活:

venv\Scripts\activate

在 macOS/Linux 上激活:

source venv/bin/activate

之后再打开终端,你跑python用的就是虚拟环境里的解释器了,装包也不会污染系统环境。

  • 如果运行时报"ModuleNotFoundError: No module named xxx",记住一句话:先在激活的虚拟环境里用pip install xxx装好,再回到 VS Code 里运行。很多人直接点击右上角的运行按钮,结果用的解释器和装包的 pip 不是同一个环境,自然找不到模块。

顺带提一嘴,很多人在搜索"学习计算机视觉需要 VS Code 和 PyCharm 安装哪个"时,其实真正该装的不是编辑器,而是 Python 科学计算环境——比如 Anaconda。Anaconda 把 Python、常见科学计算库、包管理器 Jupyter 等集成在一起,安装后你在 VS Code 里就能直接创建 Jupyter Notebook 写代码跑模型。对学计算机视觉的人来说,这个组合比纠结编辑器本身更关键。

9. 最后再分享三个实用的小技巧

写到这里,VS Code 的安装、配置、使用基本已经覆盖得差不多了。最后分享三个我实际使用中觉得特别值的小技巧:

第一个技巧是"工作区"功能。你可以在 VS Code 里通过"文件 - 将文件夹添加到工作区"把多个项目文件夹组织到一个工作区中,之后随时一键打开整套项目结构。我在同时维护前端和后端两个仓库的时候,全靠工作区管理,不然每次都要单独打开两个窗口,非常麻烦。

第二个技巧是"用户代码片段同步"。我在.vscode目录里放了一份自定义的settings.json和代码片段配置文件,然后用 Git 管理,换电脑之后直接把仓库拉下来,再配合官方设置同步,基本能做到"换了台电脑环境还和原来一样"。

第三个技巧是快捷键Ctrl + K Ctrl + S可以打开所有快捷键的交互式编辑器,你可以在这里把常用的快捷改成自己更顺手的组合。比如我把"运行 Python 文件"绑定到了Ctrl + Alt + P,少一步鼠标操作,写代码时爽快很多。

就我个人的体会而言,VS Code 最迷人的地方不在于它开箱即用的功能有多全,而在于它给了你足够的空间去把它调成独一无二的工具。从装好一个编辑器,到慢慢配上自己顺手的插件、快捷键、主题、代码片段,这个过程本身就是学习编程的一部分。希望这篇文章能帮你跨过最初的几道坎,少踩一些我当年踩过的坑,早点把 VS Code 变成真正顺手的生产力工具。

返回列表