从0到1：手把手教你搭建VSCode（附避坑指南，拒绝报错），全程复制粘贴即可

个人主页北极的代码欢迎来访作者简介java后端学习者❄️个人专栏苍穹外卖日记SSM框架深入JavaWeb✨命运的结局尽可永在不屈的挑战却不可须臾或缺前言对于刚入门C语言的小白来说最头疼的不是写代码而是“安装编辑器配置环境”——要么找不到正确的安装包要么配置时出错最后卡半天连第一个“Hello World”都跑不起来。今天这篇教程全程手把手、无专业术语、避开所有小白坑不管你是电脑小白还是第一次接触编程跟着做就能成功配置好VSCode的C语言环境顺利运行第一个C语言程序。先明确核心逻辑VSCode本身只是一个“编辑器”不能直接运行C语言需要搭配「C语言编译器」负责把代码翻译成电脑能看懂的指令再给VSCode配置编译器路径就能实现“写代码→运行代码”的全流程。我们全程以最主流的Windows系统为例macOS、Linux用户可看文末补充步骤清晰每一步都附具体操作不用自己瞎琢磨。第一步准备工具我们需要两个核心工具全程免费无需破解直接官网下载避免下载到捆绑软件VSCode编辑器用来写C语言代码轻量、免费、颜值高新手友好MinGW-w64编译器C语言的“翻译官”没有它代码无法运行。这里优先推荐用MSYS2安装MinGW-w64比直接下载MinGW更稳定、更新更快还能避免后续环境变量配置出错的问题。提示下载时全程不要改默认路径除非你知道自己在做什么不要装在中文文件夹比如“桌面\编程工具”“D:\软件\VSCode”都不行中文路径会导致后续配置失败这是小白最常踩的坑第二步安装VSCode全程下一步3分钟搞定步骤1下载VSCode打开VSCode官方网站https://code.visualstudio.com/官网无广告放心打开网站会自动识别你的电脑系统Windows点击首页的“Download for Windows”开始下载安装包大小约150MB网速快的话1分钟搞定。如果没自动识别下拉页面找到“Windows”选项选择“User Installer”推荐无需管理员权限安装更流畅下载.exe文件。步骤2安装VSCode关键勾选3个选项下载完成后找到安装包一般在“下载”文件夹双击打开全程按以下步骤操作不要乱点弹出安装向导点击“我接受协议”下一步安装路径默认即可一般是C:\Users\你的用户名\AppData\Local\Programs\Microsoft VS Code不用改下一步重点步骤附加任务勾选3个选项这一步决定后续使用是否方便缺一不可☑把VS Code添加到PATH重启后生效勾选后后续可以通过命令行快速打开VSCode☑ 在资源管理器中添加“通过Code打开”选项勾选后右键文件夹就能用VSCode打开后续管理代码更方便☑ 创建桌面快捷方式方便后续快速启动VSCode点击“安装”等待2-3分钟安装完成后点击“完成”VSCode会自动启动。用户变量中的Path然后添加路径步骤3VSCode初始化设置中文小白更友好首次打开VSCode是英文界面不用慌一键设置中文打开VSCode后点击左侧菜单栏的「扩展」图标四个小方块的图标或者按快捷键CtrlShiftX打开扩展面板在搜索框中输入“Chinese”找到“Chinese (Simplified) Language Pack for Visual Studio Code”微软官方中文包点击“安装”安装完成后右下角会弹出提示“是否重启VSCode以应用中文”点击“重启”重启后VSCode就变成中文界面了操作更简单。提示如果没弹出重启提示按CtrlShiftP输入“Configure Display Language”选择“zh-cn”再重启即可。第三步安装MinGW-w64编译器C语言运行的核心VSCode只是“写字的本子”MinGW-w64才是“能把字念出来的人”没有它代码写得再对也无法运行。我们用MSYS2来安装MinGW-w64比直接下载MinGW更稳定步骤如下步骤1下载MSYS2打开MSYS2官方网站https://www.msys2.org/点击首页的“Download the installer”下载MSYS2安装包文件名类似msys2-x86_64-xxxx.exe大小约5MB。步骤2安装MSYS2双击下载好的安装包点击“Next”安装路径建议默认C:\msys64不要改也不要放在中文路径下点击“Next”开始菜单快捷方式默认即可点击“Next”点击“Install”等待安装完成勾选“Run MSYS2 now”点击“Finish”会自动打开MSYS2终端窗口。步骤3更新包管理器并安装MinGW-w64工具链MSYS2打开后会弹出一个黑色终端窗口我们需要在终端中输入命令完成更新和安装全程复制命令即可不用手动输入第一步更新系统包。在终端中输入命令pacman -Syu然后按回车键此时会提示是否继续更新输入“Y”大写小写都可以按回车键等待更新完成可能需要几分钟耐心等待不要关闭终端如果更新过程中提示“close the terminal”直接关闭当前终端重新打开MSYS2再次输入pacman -Syu直到更新完成第二步安装MinGW-w64工具链。输入命令pacman -S mingw-w64-x86_64-gcc64位系统推荐几乎所有现代电脑都是64位按回车键提示是否安装输入“Y”按回车键等待安装完成工具链较大约150MB耐心等待安装完成后关闭MSYS2终端即可。步骤4配置MinGW-w64环境变量最关键避免后续报错环境变量的作用让电脑全局识别MinGW-w64的编译器命令比如gcc这样VSCode才能找到编译器小白一定要严格按步骤来右键点击“此电脑”选择“属性”如果桌面没有“此电脑”可以在开始菜单中找到在弹出的窗口中点击“高级系统设置”在弹出的“系统属性”窗口中点击“环境变量”在“用户变量”或“系统变量”中找到“Path”变量点击“编辑”推荐修改用户变量无需管理员权限点击“新建”输入MinGW-w64的bin目录路径C:\msys64\mingw64\bin如果你的MSYS2安装路径改了就对应修改默认路径就是这个点击“确定”依次点击所有弹出窗口的“确定”保存设置一定要点确定否则配置不生效验证环境变量是否配置成功按下WinR输入“cmd”打开命令提示符输入gcc --version按回车键。如果弹出gcc的版本信息类似“g (Rev9, Built by MSYS2 project) 13.2.0”说明配置成功如果提示“gcc不是内部或外部命令”说明环境变量配置错误重新检查步骤57的路径是否正确或重启电脑再试。第四步VSCode配置C语言环境最后一步搞定就能写代码此时我们已经有了VSCode写字本和MinGW-w64翻译官现在需要让VSCode和编译器“打通”配置完成后就能写代码、运行代码了。步骤1安装C/C扩展VSCode支持C语言的关键打开VSCode点击左侧的「扩展」图标四个小方块或按CtrlShiftX在搜索框中输入“C/C”找到“C/C”微软官方扩展图标是蓝色的“C”点击“安装”安装完成后无需重启VSCode直接进行下一步即可如果提示重启就重启。提示可选安装“Code Runner”扩展搜索“Code Runner”安装后可以一键运行代码更方便小白操作。步骤2创建C语言项目文件夹规范管理代码不要直接在桌面写代码创建一个专门的文件夹避免文件混乱步骤如下在电脑D盘或E盘新建一个文件夹命名为“C语言学习”不要用中文不这里可以用中文只要文件夹路径没有特殊符号即可打开VSCode点击左上角“文件”→“打开文件夹”找到刚才新建的“C语言学习”文件夹点击“选择文件夹”在VSCode左侧的“资源管理器”中就能看到这个文件夹了后续所有C语言代码都放在这里。步骤3创建配置文件自动生成无需手动写代码配置文件的作用告诉VSCode“用哪个编译器”“怎么编译代码”小白不用懂代码按步骤操作即可自动生成在VSCode左侧“资源管理器”中右键点击“C语言学习”文件夹选择“新建文件”文件名输入“test.c”.c是C语言文件的后缀必须加上否则不是C语言文件打开test.c文件随便输入一句简单的C语言代码比如#include stdio.h int main(){printf(Hello World);return 0;}保存文件按CtrlS按快捷键CtrlShiftP弹出命令面板输入“C/C: Edit Configurations (UI)”点击进入配置界面在配置界面中找到“编译器路径”点击后面的“浏览”找到MinGW-w64的gcc.exe文件路径是C:\msys64\mingw64\bin\gcc.exe选择后点击“确定”“IntelliSense模式”选择“gcc-x64”其他选项默认即可配置完成后VSCode会自动在文件夹中生成一个“.vscode”文件夹里面包含配置文件无需手动修改。步骤4配置任务编译代码的规则在VSCode中点击顶部“终端”→“配置任务”→“创建tasks.json文件”选择“使用模板创建tasks.json文件”再选择“Others”VSCode会自动生成tasks.json文件将生成的tasks.json文件内容替换为以下代码复制粘贴即可不要改任何内容{version: 2.0.0,tasks: [{label: build,type: shell,command: gcc,args: [-g,${file},-o,${fileDirname}/${fileBasenameNoExtension}],group: {kind: build,isDefault: true},problemMatcher: $gcc}]}保存文件CtrlS关闭tasks.json文件即可。代码解释小白不用记了解即可label是任务名称command是编译器命令args是编译参数确保编译后的文件和源代码在同一个文件夹中方便查找。步骤5配置调试可选调试功能可以帮我们找到代码中的错误小白前期写简单代码可以不用但建议配置好后续排查错误更方便点击VSCode左侧的「调试图标」小虫子图标或按CtrlShiftD点击“创建launch.json文件”选择“C/C (GDB/LLDB)”再选择“默认配置”将生成的launch.json文件内容替换为以下代码复制粘贴{version: 0.2.0,configurations: [{name: Debug C,type: cppdbg,request: launch,program: ${fileDirname}/${fileBasenameNoExtension},args: [],stopAtEntry: false,cwd: ${workspaceFolder},environment: [],externalConsole: true,MIMode: gdb,miDebuggerPath: gdb,preLaunchTask: build}]}保存文件CtrlS调试配置就完成了。第五步测试是否配置成功关键验证小白必做配置完成后我们写一个简单的C语言程序测试能否正常运行步骤如下打开之前创建的test.c文件输入以下代码复制粘贴即可这是C语言最基础的“Hello World”程序#include stdio.hint main() {// 小白注释这是第一个C语言程序打印Hello Worldprintf(Hello World! 我是小白我配置成功啦\n);return 0;}保存文件CtrlS运行代码有两种方式小白推荐第一种方式1Code Runner扩展如果安装了Code Runner点击代码右上角的“运行”图标▶️会弹出黑色终端窗口显示“Hello World! 我是小白我配置成功啦”说明运行成功方式2终端运行按CtrlShift键盘左上角的波浪号打开VSCode终端输入命令gcc test.c -o test按回车键编译代码再输入test.exe按回车键会显示运行结果。如果能正常显示结果说明VSCode和C语言环境已经配置成功恭喜你已经迈出了C语言学习的第一步。常见问题排查必看避免踩坑配置过程中小白可能会遇到一些问题不用慌对照以下情况排查就能解决问题1输入gcc --version提示“gcc不是内部或外部命令” 解决环境变量配置错误。重新检查MinGW-w64的bin目录路径C:\msys64\mingw64\bin是否正确添加到Path中添加后重启电脑再重新验证。问题2VSCode运行代码提示“没有找到编译器” 解决C/C扩展未安装或编译器路径配置错误。重新安装C/C扩展再按步骤3配置编译器路径。问题3运行代码终端显示乱码 解决VSCode编码问题。点击VSCode右下角的“UTF-8”选择“通过编码保存”再选择“GBK”保存文件后重新运行即可。问题4配置文件报错提示“路径错误” 解决文件夹路径包含中文或特殊符号比如“C:\用户\张三\C语言学习”重新创建文件夹路径不要有中文、空格、特殊符号再重新配置。问题5MSYS2安装MinGW-w64失败 解决网络问题重新打开MSYS2再次输入安装命令或更换网络后重试如果还是失败可直接下载MinGW-w64压缩包解压后配置环境变量参考文末补充。补充macOS、Linux用户配置说明简要版1. macOS用户安装VSCode官网下载.dmg文件将VSCode拖入“应用程序”即可后续设置中文和安装C/C扩展和Windows步骤一致安装编译器打开终端输入命令xcode-select --install安装Xcode Command Line Tools包含Clang编译器无需配置环境变量安装完成后即可使用后续配置tasks.json和launch.json和Windows步骤一致无需修改路径。2. Linux用户以Ubuntu为例安装VSCode打开终端输入命令sudo apt update再输入sudo apt install -y code安装完成后终端输入code即可启动安装编译器终端输入命令sudo apt-get install build-essential安装GCC编译器无需配置环境变量后续配置和Windows步骤一致无需修改路径。最后总结小白配置VSCodeC语言环境核心就3步安装VSCode→安装MinGW-w64编译器配置环境变量→给VSCode配置编译器路径和任务。全程不用懂专业术语不用手动写复杂代码跟着步骤一步步来30分钟内就能搞定顺利运行第一个C语言程序。配置完成后就可以开始学习C语言语法了后续写代码、运行代码、调试代码都能在VSCode中完成。如果遇到其他问题评论区留言看到会第一时间回复祝大家都能顺利入门C语言少踩坑、多进步