VSCode 这个编辑器对我来说已经不是“要不要用”的问题而是“换到哪台机器都要第一时间装回来”的问题。它开源、免费、跨平台启动比传统 IDE 快很多装上扩展之后又能完成 C/C、Python、前端、Markdown 这些日常开发工作。你搜“vscode使用教程 2026最新版”多半是想在一篇文章里解决三件事怎么安装、怎么把界面改成中文、怎么把 C/C 编译调试环境跑通。这篇文章就按这个顺序写。界面版本会一直更新但核心操作路径非常稳定照着做不需要等某个特定版本。先说一个最容易被忽略的认知VSCode 本身只是编辑器不是完整 IDE。它不会自带 C/C 编译器也不会自动生成编译命令。很多人卡在“装好了但按 F5 报错”不是操作错了而是少装了编译器。这篇文章会专门解决这个问题。1. 安装之前先弄清三件事版本、系统、路径1.1 VSCode 和 Visual Studio 不是同一个东西很多刚入门的人会把 VSCode 和 Visual Studio 混在一起。这是两类完全不同的软件。Visual Studio 是微软出的重型 IDE体积大安装包几个 GB自带 MSVC 编译器适合做 Windows 桌面、.NET、Unity 等大型项目。VSCode 是轻量级代码编辑器安装包只有一两百 MB启动快通过插件扩展功能适合写 C/C、Python、前端、脚本、Markdown 等各种语言。如果你只是想学 C/C 语法、做算法题、写课程作业VSCode 完全够用。如果你以后要长期做 Windows 桌面开发再考虑 Visual Studio 也不迟。这篇文章只讲 VSCode。1.2 系统要求其实很低VSCode 支持 Windows、macOS、Linux。Windows 系统一般 Win10 及以上都能正常使用Win7 老版本可能受限于新版系统组件建议直接升级系统。内存 8GB 会比较舒服4GB 也能跑只是扩展装多了、项目文件大了以后会明显变慢。磁盘方面VSCode 本身占用很小但 C/C 扩展和编译器会占几个 GB 空间。安装前最好确认系统盘剩余空间充足。1.3 下载入口和安装路径怎么选下载一定要去官网。直接搜索“VSCode 官网”或“VSCode download”认准官方域名。很多第三方下载站会把旧版本、捆绑安装器或者带广告的版本放在搜索结果前面这类东西不干净。官网首页会清楚写着“Download for Windows / macOS / Linux”。Windows 用户建议选 64 位 User Installer。它和 System Installer 的区别在于User Installer装在当前用户目录不需要管理员权限自动更新更顺畅。System Installer装在系统 Program Files需要管理员权限适合一台机器多个用户共用。我建议个人电脑默认用 User Installer。学校机房或公司电脑没有管理员权限时用 User Installer 也能正常安装这是很实用的一个小技巧。安装路径建议保持默认或者放 D 盘也可以。但路径里尽量不要带中文目录名也不要带空格尤其以后要装 MinGW-w64 编译器时路径有空格可能引发奇怪的问题。VSCode 本身对路径宽容但编译器和 make 工具不宽容。安装过程中的“添加到 PATH”和“在终端中打开”选项要勾上。这个很关键后面在终端里直接输入 code 命令打开项目或者让系统能找到命令行工具都靠这两个选项。2. 下载安装和中文设置2.1 安装向导里哪些选项值得勾选安装界面点“下一步”时有几个选项会影响日常使用建议这样选选项建议原因添加到 PATH勾选允许在终端里直接输入code打开 VSCode在目录上下文菜单中打开勾选右键文件夹直接使用 VSCode 打开创建桌面快捷方式按习惯不影响使用在终端中打开勾选关联“在终端中用 VSCode 打开文件”操作“将代码注册为受支持文件的编辑器”可选新手不建议勾容易让系统默认打开方式被改掉安装完成后桌面会出现 VSCode 图标或者在开始菜单里找到它。第一次打开后界面是英文的这是正常现象下一步做汉化。2.2 安装官方中文语言包VSCode 界面汉化不需要额外下载安装包直接在扩展市场里装语言包就行。操作步骤打开 VSCode点击左侧边栏最下方的“方块”图标或者按快捷键CtrlShiftX打开扩展面板。在搜索框输入Chinese。找到名为Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code的扩展。点击 Install安装。装完后VSCode 右下角通常会自动弹出一个提示问你是否要切换到中文界面。如果没有弹窗可以按CtrlShiftP打开命令面板输入Configure Display Language选择zh-cn。然后重启 VSCode界面就是中文的了。这个语言包是官方出的维护频率高不会出现“汉化不完全”的问题。有一些第三方汉化插件不推荐装功能重复还有扩展冲突风险。2.3 汉化后第一件事认识三个核心区域汉化完成后建议先花两分钟熟悉界面布局左侧活动栏文件资源管理器、搜索、源代码管理、运行和调试、扩展。编辑器区域写代码的主要区域可以多标签页并列。底部面板终端、问题、输出、调试控制台。最常用的两个快捷键CtrlShiftX扩展面板。Ctrl打开集成终端。VSCode 内置终端很重要。运行编译命令、查看报错信息、执行脚本都离不开它。3. C/C 环境真正的核心不是 VSCode是编译器3.1 为什么配置 VSCode 老是卡住新手配置 C/C 环境最容易犯的错误是以为“装上 VSCode C/C 插件”就结束了。实际上 VSCode 只提供编辑和调试界面真正把.cpp文件变成.exe的是编译器。Windows 上常见的 C/C 编译器组合是 MinGW-w64 中的g和gdb。g负责编译gdb负责调试。VSCode 的 C/C 扩展负责调用这两个工具并在界面上展示结果。所以配置顺序应该是安装编译器。确认编译器能在终端里运行。安装 VSCode 的 C/C 扩展。配置任务和调试文件。顺序反了就会一路报错。3.2 安装 MinGW-w64 的两种方式MinGW-w64 是 Windows 上可用的 GNU 工具链。获取方式一般有两种方式一通过 MSYS2 安装。MSYS2 是一个软件发行平台里面包含 MinGW-w64 工具链。安装 MSYS2 后在它的终端里执行一条命令就能装好编译器pacman -S --needed base-devel mingw-w64-x86_64-toolchain装完后把类似C:\msys64\mingw64\bin的目录加到系统 PATH 里。方式二使用 winlibs 或 w64devkit 这类独立发行版。它们是把编译器和调试器打包好的压缩包解压后配置环境变量就能用不需要额外安装平台。适合只想快点跑通环境的用户。这个地方最容易踩坑很多人下载了 MinGW但没有把bin目录加到 PATH或者加错了路径。结果 VSCode 里始终提示找不到g或gdb。3.3 配置环境变量并验证Windows 配置 PATH 的步骤右键“此电脑”或“我的电脑”选择“属性”。点击“高级系统设置”。点击“环境变量”。在下方的“系统变量”里找到Path双击或点“编辑”。点击“新建”把编译器bin目录的完整路径加进去例如C:\msys64\mingw64\bin。点“确定”保存。配置完成后重开一个终端窗口执行gcc --version g --version gdb --version三个命令都正常输出版本信息说明环境变量生效了。我一般会在这时候先直接在终端里手动编译一个最简单的源文件确保编译器本身没问题再回到 VSCode 里做配置。这样可以避免“VSCode 配置有问题”和“编译器有问题”混在一起排查起来更干净。注意环境变量配置完成后一定要完全关闭并重新打开 VSCode而不是只关掉终端面板。VSCode 进程会缓存环境变量不重启的话终端里依然找不到g。4. 三个 JSON 文件决定你能一键编译和调试4.1 先装 C/C 扩展在扩展面板搜索C/C安装由微软官方发布的扩展支持 C、C 的语法高亮、智能提示、调试和代码补全。这个扩展名称是C/C发布者为 MicrosoftID 是ms-vscode.cpptools。安装完成后打开一个.cpp文件VSCode 通常会弹出几个提示框比如“IntelliSense 配置需要更新”不要慌这是正常提示。4.2 c_cpp_properties.json告诉 IntelliSense 去哪找头文件按CtrlShiftP输入C/C: 编辑配置(JSON)会生成一个c_cpp_properties.json文件。它主要负责智能提示不负责编译。一个常见配置长这样{ configurations: [ { name: Win64, includePath: [ ${workspaceFolder}/** ], compilerPath: C:/msys64/mingw64/bin/g.exe, cStandard: c17, cppStandard: c17, intelliSenseMode: windows-gcc-x64 } ], version: 4 }compilerPath要改成你自己的 g 路径。这里路径分隔符用斜杠/不用反斜杠。如果写代码时总提示“无法打开源文件”或找不到头文件优先检查includePath和compilerPath。4.3 tasks.json告诉 VSCode 怎么编译按CtrlShiftP输入任务: 配置默认生成任务选择“使用模板创建 tasks.json 文件”再选“Others 运行任意外部命令”然后替换成典型内容{ version: 2.0.0, tasks: [ { label: C 编译, type: shell, command: g, args: [ -g, ${file}, -o, ${fileDirname}/${fileBasenameNoExtension}.exe ], group: { kind: build, isDefault: true }, problemMatcher: [$gcc] } ] }解释几个参数-g生成调试信息没有这个参数调试器断点会失效。${file}当前打开的文件只编译当前文件。${fileDirname}/${fileBasenameNoExtension}.exe生成的可执行文件放在当前文件目录名字和源文件一样后缀换成.exe。这样配置之后按CtrlShiftB就能编译当前打开的文件。4.4 launch.json告诉 VSCode 怎么调试在左侧活动栏点击“运行和调试”图标选择“创建 launch.json 文件”再选择“C (GDB/LLDB)”。一个常见的配置长这样{ version: 0.2.0, configurations: [ { name: C 调试, type: cppdbg, request: launch, program: ${fileDirname}/${fileBasenameNoExtension}.exe, args: [], stopAtEntry: true, cwd: ${fileDirname}, environment: [], externalConsole: false, MIMode: gdb, miDebuggerPath: C:/msys64/mingw64/bin/gdb.exe, setupCommands: [ { description: 为 gdb 启用整齐打印, text: -enable-pretty-printing, ignoreFailures: true } ], preLaunchTask: C 编译 } ] }这里的preLaunchTask必须和tasks.json里的label完全一致。不匹配的话按 F5 时会提示找不到任务。配置里把stopAtEntry设为true调试启动后会停在main函数入口处。新手刚开始建议保留方便观察断点是否生效。4.5 中文乱码和终端显示问题的处理Windows 控制台默认编码是 GBKVSCode 保存文件默认是 UTF-8。如果代码里有中文编译后运行会出现乱码。常见解决办法在代码开头加setlocale(LC_ALL, zh_CN.UTF-8);并包含locale.h。或者在 tasks.json 里给 g 加一个参数-fexec-charsetGBK这个参数告诉编译器生成的可执行文件里使用 GBK 编码输出配合 Windows 控制台的默认编码中文能正常显示。我个人更常用方案一代码里显式设置 locale跨平台时兼容性更好。5. 写第一个程序跑通编译和调试5.1 最小可运行样例新建一个文件夹比如D:\CppProjects\hello。在 VSCode 里打开这个文件夹新建hello.cpp#include iostream int main() { std::cout Hello, VSCode! std::endl; return 0; }保存文件后按CtrlShiftB编译。如果没有报错终端里会显示任务执行成功。此时文件夹里会多出一个hello.exe。接着在集成终端里执行./hello.exe看到输出Hello, VSCode!说明编译环境完全正常。5.2 五个高频报错和对应处理现象常见原因处理方式g 不是内部或外部命令环境变量没配好或 VSCode 未重启在系统终端执行g --version确认 PATH重启 VSCode无法打开源文件 iostreamc_cpp_properties.json的 compilerPath 错误确认 compilerPath 指向 g 实际位置按 F5 后找不到任务 C 编译tasks.json 的 label 与 launch.json 的 preLaunchTask 不一致打开两个 JSON 文件逐行对比 label程序闪退看不到输出externalConsole 为 false运行完窗口直接关闭临时在代码 return 前加std::cin.get();或把 externalConsole 设为 true中文乱码源文件编码和终端编码不一致用 locale 或 -fexec-charsetGBK 处理5.3 遇到问题时按这个顺序排查很多问题表面看是“VSCode 配置错了”实际不是。我一般按照下面这个顺序排查看报错提示。是编译报错、调试器报错还是找不到文件。在系统终端里直接执行g --version和gdb --version。如果这里都不通过就不用在 VSCode 里浪费时间。在终端里手动编译一次g hello.cpp -o hello.exe。能通过说明编译器没问题问题在 VSCode 的 JSON 配置。检查 tasks.json 里的 command 和 args。尤其是路径里的斜杠、反斜杠、空格。检查 launch.json 里 program 指向的 exe 是否真实存在。编译失败时launch.json 找不到 exe也会报类似错误。只要按这个顺序排查大部分配置问题能在几分钟内定位。6. 从入门到顺手建议按这个顺序加配置6.1 几个值得优先装的扩展C/C 环境跑通后不要急着装一堆插件。先装几个日常影响最大的就够了。扩展名作用C/C语法提示、调试支持Code Runner快速运行单文件代码写题测试时很好用GitLens查看 git 历史、代码是谁改的Markdown All in OneMarkdown 编辑增强写学习笔记方便Error Lens把错误信息直接显示在代码行尾“Code Runner”适合快速测试。但要注意它按代码右上角的三角播放键运行使用的是g快速编译模式默认不会生成调试信息也不走 tasks.json 的 build 流程。所以日常测试语法、跑简单算法题用 Code Runner。想打断点、单步调试、观察变量必须用 F5 调试模式。不要混为一谈。遇到过不少同学按了 F5 调试却一直以为是 Code Runner 在跑结果发现断点没生效其实是跑的不是调试配置。6.2 建议养成的配置习惯开启自动保存文件-自动保存或者设置files.autoSave为afterDelay。手动按CtrlS也能接受但配置调试时不建议依赖手动保存。打开“保存时格式化”设置里搜editor.formatOnSave勾选。配合 C/C 扩展代码会保持规范缩进。学会使用工作区在 VSCode 里点击“文件” - “将文件夹添加到工作区”。一个项目对应一个工作区可以在工作区文件里保存专属配置不会污染全局设置。开启设置同步登录微软账号或 GitHub 账号启用设置同步。这样换电脑后扩展、快捷键、设置都能一键同步回来。6.3 从单文件到多文件编译前面的 tasks.json 是针对单文件编译的。当你一个项目里有多个.cpp文件时编译命令需要改成g -g main.cpp utils.cpp -o project.exe可以把所有.cpp文件都列在args里也可以用通配符args: [ -g, ${workspaceFolder}/*.cpp, -o, ${workspaceFolder}/project.exe ]但通配符在 Windows shell 下不一定每次都可靠。更稳妥的做法是用 CMake 管理多文件项目然后安装 CMake Tools 扩展。这一步可以等单文件调试熟练后再学不需要一开始就上。6.4 版本更新时需要注意什么VSCode 的版本更新速度很快2026 年的版本可能已经换过几次界面布局了。但不用担心核心逻辑没变扩展面板还在左侧活动栏。命令面板还是CtrlShiftP。配置 JSON 的结构保持兼容。C/C 扩展、MinGW-w64、tasks.json、launch.json 这套体系非常稳定。如果某次更新后发现右键功能不见了或快捷键变了不用急着重装先去设置里搜相关关键词一般都能在“用户设置”里重新绑定。最后留一个实际建议如果你只是学习 C/C不要一开始就追求复杂的工程配置。先让安装、汉化、编译、调试这一条链路跑通再多花两三天熟悉快捷键和 JSON 文件的作用。后期真正进入项目开发时你会有余力去研究 CMake、静态检查、单元测试这些更上层的东西。第一步永远是让环境不再成为阻碍。