VS Code中文环境配置及调试 保姆级教程!

前言:最近在配置Visual Studio Code(下面将简称 VS Code)环境,网上关于中文调试的教程很少,博主参考别的教程配置了很多次都不行,这篇文章步骤经过摸索而成,下面将一步一步搭建VS Code环境以及中文编译 C/C++ 代码。

环境:

VS Code:1.96.4

OS Windows_NT x64 10.0.26100.2894

1. 引言 ·VS Code(Visual Studio Code)的特点与优势

Visual Studio Code(简称VS Code)是一款由微软开发的轻量级、功能强大的源代码编辑器。它支持多种编程语言,具备强大的插件扩展功能,能够满足不同开发需求。VS Code不仅支持多种操作系统(Windows、Mac、Linux),而且界面简洁、启动速度快,深受开发者喜爱。它的智能代码补全、调试功能和版本控制集成功能,让开发者可以高效地进行代码编写、调试和版本管理。

对于初学者来说,VS Code提供了易于上手的环境,而对于有经验的开发者,VS Code的高度可定制性和扩展性能够满足各种复杂的开发需求。因此,VS Code已成为全球开发者的首选工具之一。

·本教程的目标和读者对象

目标
本教程旨在帮助初学者,掌握如何在VS Code中配置中文语言环境并进行调试。通过这篇教程,读者将能够:

顺利安装和配置VS Code,并将其设置为中文环境。

安装并配置常用插件,提高开发效率。

掌握VS Code调试功能的使用,进行代码调试,排查错误。

解决常见问题,确保VS Code的使用顺畅。

读者对象
本教程适合以下读者:

初学者:对VS Code不熟悉或刚开始接触开发工具的用户,教程提供配置VS Code的详细步骤,帮助你轻松上手。

中文用户:希望将VS Code设置为中文环境的用户,教程将详细介绍如何设置中文语言包和解决可能遇到的问题。

2. 安装VS Code 下载与安装步骤

下载VS Code

下载地址:Visual Studio Code - Code Editing. Redefined

进入官网后点击下载即可。

安装VS Code(Windows)

好下载完成后,双击安装包启动安装程序。

安装程序。

              1. 在安装向导中,可以选择自定义安装路径,也可以保持默认设置。

     

                2. 在安装过程中,可以选择添加VSCode到环境变量和桌面快捷方式等选项,推荐勾选以便日后快速启动。
 

                3.点击安装。
 

                4.完成并打开VS Code。(点击完成)

3. 配置中文语言环境

首次打开VS Code

 若页面与图片不同,且并不会配置环境,建议完全卸载VS Code(包括注册表信息)重新配置。

这里推荐卸载软件:HiBit Uninstaller

下载中文语言包插件

点击插件下载,在搜索框中输入"chinese",选择第一个下载后,并重启VS Code。

 4. 配置C/C++环境

下载C/C++拓展

 按图示操作即可。

配置编译器

选择合适的编译器。

这里我选择的是mingw。                                                               
下载地址:Pre-built Toolchains - mingw-w64

                ·下载编译器

              ·编译器的选择

                Windows 平台

                        如果你是 Windows 11 64位 用户:

                         推荐:
                                  ✅ llvm-mingw-20250114-msvcrt-x86_64.zip (适用于Windows 64位,使用MSVCRT运行时库)
                              ✅ llvm-mingw-20250114-ucrt-x86_64.zip (适用于Windows 64位,使用UCRT运行时库)

                        如何选择 MSVCRT 或 UCRT?

                        MSVCRT(Microsoft C Runtime):兼容性更好,适用于大多数传统Windows程序。

                        UCRT(Universal C Runtime):推荐用于新项目,兼容性更强,支持Windows 10及以上。

                          如果你的项目没有特殊要求,建议选择 llvm-mingw-20250114-msvcrt-x86_64.zip。如果你想使用更现代的 UCRT 运行时,可以选择 llvm-mingw-20250114-ucrt-x86_64.zip。

                        非 Windows 用户

                        如果你使用 Linux 或 macOS,请选择:

                        Ubuntu 64位:llvm-mingw-20250114-msvcrt-ubuntu-20.04-x86_64.tar.xz

                        macOS:llvm-mingw-20250114-ucrt-macos-universal.tar.xz

              解压编译器               配置环境变量

                        ·打开编译器文件夹的bin目录。

                         ·复制当前路径用来配置环境变量

                         ·我的电脑->右键属性->高级系统设置->环境变量

               

                       ·在系统变量中找到Path。

                        ·点击新建,将刚才复制的路径粘贴进来并依次点击刚才打开的3个界面的确定按钮。(这里环境变量的顺序是系统查找的顺序,可以将其上移至前面。)

                        ·最后按下WIN+R键打开cmd终端,运行命令gcc -v查看编译器版本,出现GCC版本号即表示GCC编译器安装成功。

 5. 配置调试环境

创建代码文件夹

先点击VS Code资源管理器,即步骤一,再点击打开文件夹。                                             
                                     

选择合适的位置创建你储存代码的文件夹。
注意:选择的路径文件名可以包含字母、数字和下划线(_)。避免使用特殊字符、空格或其他非法字符,以确保文件名在各种操作系统上的兼容性。

创建代码文件

 按照箭头所示顺序点击,并为其命名。

配置编译

              1. 书写测试代码(Hello, World!)

#include <iostream> using namespace std; int main() { cout << "Hello, World!"; return 0; }

                2. 按快捷键F1调出命令面板,输入C/C++,选择“Edit Configurations(UI)”进入配置。这里配置两个选项: - 编译器路径:D:/compiler/llvm-mingw-20250114-msvcrt-x86_64/bin/g++.exe

这里的编译器路径根据自己安装的MINGW编译器选择。

配置构建任务

接下来,创建一个tasks.json文件来告诉VS Code如何构建(。该任务将调用g++编译器基于源代码创建可执行文件。 按快捷键F1调出命令面板,输入tasks,选择“Tasks:Configure Default Build Task”:

再选择“C/C++: g++.exe 生成活动文件”:

配置调试设置

因为mingw编译器默认下载是不含gdb调试器的,只含lldb调试器,若想使用gdb调试器需先下载。

下载gdb调试器。

下载地址:Pre-built Toolchains - mingw-w64
 

下载调试器
 

配置环境变量,重复之前操作将编译器的bin目录添加至系统环境变量中。
 

检查调试器安装。
按下WIN+R键打开cmd终端,运行命令gdb -v查看调试器版本,出现gdb版本号即表示GCC调试器安装成功。
 

这里主要是为了在.vscode文件夹中产生一个launch.json文件,用来配置调试的相关信息。先点击前面创建的test文件,再点击资源管理器的运行于调试-->创建launch.json文件:






点击c/c++:(gdb)启动


若未出现上图标识,点击右下角添加配置即可。



最后根据其中的提示,进行修改和配置就可以啦。

注意:

lauch.json 用于设置调试、运行时的设置;

tasks.json 用于设置编译时的设置。


lauch.json文件中:

preLaunchTask:该值需要与tasks.json中的label相同,否则调试时会提示找不到;
externalConsole:外部终端是否开启
其他的键,一般不用修改:

name:显示在‘’调试”(Run)侧边栏的名字;
type:类型。不能改;
request:有launch和attach可选,这里填launch,按下F5就可以启动调试了;而不是attach(附加);
program:程序所在路径和程序名,更多变量在官方文档;
args:这里填命令行参数(main函数的形参),如果没有可不填;
stopAtEntry:为true时,在开始运行程序时,不立刻往后执行,先暂停一下,一般填false;
cwd:目标工作目录,在哪个目录调试程序,一般在当前文件夹(项目所在文件夹);
environment:临时手动添加环境变量;
MIMode:指定调试器gdb或lldb。

miDebuggerPath:调试器的路径


tasks.json文件中:
label:需要与launch.json中的preLaunchTask保持一致,否则调试时会提示找不到;
command:编译器所在的位置
args:编译参数。
cwd:运行时程序的工作目录,一般与command编译器的路径一致。

大家如果不想自己配置可以将博主配置好的launch.json文件直接复制使用

{ // 使用 IntelliSense 了解相关属性。 // 悬停以查看现有属性的描述。 // 欲了解更多信息,请访问: https://go.microsoft.com/fwlink/?linkid=830387 "version": "0.2.0", "configurations": [ { "name": "(gdb) 启动", "type": "cppdbg", "request": "launch", "program": "${fileDirname}\\${fileBasenameNoExtension}.exe", "args": [], "stopAtEntry": false, "cwd": "${fileDirname}", "environment": [], "externalConsole": false, "MIMode": "gdb", "miDebuggerPath": "D:\\compiler\\mingw64\\bin\\gdb.exe", "setupCommands": [ { "description": "为 gdb 启用整齐打印", "text": "-enable-pretty-printing", "ignoreFailures": true }, { "description": "将反汇编风格设置为 Intel", "text": "-gdb-set disassembly-flavor intel", "ignoreFailures": true } ], "preLaunchTask": "C/C++: g++.exe 生成活动文件" } ] } 注意:这里的"miDebuggerPath"需读者改为自己的调试器路径

如果读者不想再继续安装gdb调试器,可以直接使用lldb调试器,但需要在VS Code中下载插件CodeLLDB。

·下载插件

·配置launch.json
重复创建launch.json操作。

添加配置后,根据自己需求修改即可。
博主的launch.json文件

{ // 使用 IntelliSense 了解相关属性。 // 悬停以查看现有属性的描述。 // 欲了解更多信息,请访问: https://go.microsoft.com/fwlink/?linkid=830387 "version": "0.2.0", "configurations": [ { "type": "lldb", "request": "launch", "name": "Launch", "program": "${workspaceFolder}/${fileBasenameNoExtension}", "args": [], "cwd": "${workspaceFolder}" } ] }

尝试编译并调试Hello world文件

开始调试

注意:如果出现“生成任务失败”,请检查task.json文件。
若出现“调试失败”,请检查launch.json文件。

这里已经调试成功,并生成exe文件,复杂程序时,读者可设置断点自己调试。
 

调试中文(出现错误)

现在我们将Hello World!代码改为中文,并以数组形式存储。
代码如下:
  #include <iostream> using namespace std; int main() { // 定义字符数组并初始化 char message[100] = "你好 世界!"; // 输出数组内容 std::cout << message << std::endl; return 0; }

开始调试
点击侧边菜单栏资源管理器,点击test.cpp文件,第6行代码左侧鼠标左键设置断点,并在键盘上按下F5快捷键进行调试。



此时调试成功



再按下F10快捷键,进入下一行



此时代码执行完第6行,执行至第9行(还未执行)。观察变量message会发现,存储内容并不是“你好 世界!”。这是因为中文字符由多个字节组成。当在调试器变量框中查看字符数组时,显示的是每个字节对应的整数值。比如 “你”“好” 这些字符在 UTF - 8 编码下分别由多个字节存储,调试器就将这些字节以整数形式展示出来了。

想要观测中文,我们可以在监视窗口打下“变量名,8”来观测如:
 

最后点击红色方框退出即可。

ps:之前该方法可行,但不知道为什么,突然失效了。希望评论区大佬指正QAQ。





 

终端输出中文

此时再次左键第六行左侧,取消断点,并按下快捷键F5运行。最后可见终端输出中文。


 

在这一步中,大多数情况会出现乱码,那如果出现乱码该如何解决呢?

首先,检查VS Code默认终端。
·按下快捷键F1,输入搜索:“erminal: Select Default Profile” ,点击“选择默认配置文件”




此时含有“配置文件”的即为当前终端,如图博主现在的终端是cmd。


 

查看终端编码
根据VS Code中你的终端,打开该终端(必须使用管理员方式运行!)
·以cmd为例

在菜单栏中搜索cmd,找到命令提示符并右键,点击以管理员方式运行。



打开后在白色区域右键,并点击属性



在这里你可以看见你的终端编码方式
 

修改编码
在右下角先点击utf-8,再点击通过编码保存,重复操作,最后点击通过编码打开。(该方法只适用于已经写好的文件)


在编码保存和编码打开中统一格式,如上述终端编码中为gbk,则在两处均选择gbk。



再次运行就可以了。 ps:如果还是出现错误,可以尝试将launch.json文件中的externalConsole设置为true。
博主感觉可能与这个有关:
 

 

·设置默认编码
打开设置



在搜索框中输入encoding,勾选Auto Guess Encoding,在下面Encoding中选择你终端的编码即可。(该方法只对未来创建的文件有效,已创建的文件须按第一个方法修改)。


 

这里的问题是因为编码解码不相同导致,所以我们只要保证存储时的编码,终端的编码,以及解码相同就不会出现错误了。所以我们要查看VS Code使用的终端与使用终端的编码和VS Code是否一致。

文件写入中文

修改代码
  #include <iostream> using namespace std; int main() { FILE *p = NULL; p = fopen("test.txt","w"); fprintf(p, "你好 世界!"); fclose(p); return 0; } 快捷键F5运行,生成test.txt文件,打开查看。
 


此时文件没有出错。
那如果出现乱码该如何检查呢?
 

与上一个问题相同,均是编码解码不一致导致的
此时点击文件左上角文件,再点击另存为。


此时的编码便是文件的默认编码。
 


最后修改为对应编码就可以了。

完结撒花✿✿ヽ(°▽°)ノ✿✿✿ヽ(°▽°)ノ✿

终于写完了!!!!

最后附上参考各大佬的链接:vscode 文件配置launch.json tasks.json - 冰糖葫芦很乖 - 博客园

【VSCode】调试器debugger详细使用手册_vscode debug-CSDN博客

美化可参考:VSCode 安装使用教程 环境安装配置 保姆级教程_vscode安装包-CSDN博客
 

最后的最后,如果有错误或遗漏的地方,欢迎评论区大佬批评指正。

✿✿ヽ(°▽°)ノ✿             ✿✿ヽ(°▽°)ノ✿        ✿✿ヽ(°▽°)ノ✿        ✿✿ヽ(°▽°)ノ✿

2025-02-22 08:29 点击量:3