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。(点击完成)
首次打开VS Code
若页面与图片不同,且并不会配置环境,建议完全卸载VS Code(包括注册表信息)重新配置。
这里推荐卸载软件:HiBit Uninstaller
下载中文语言包插件
下载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编译器安装成功。
创建代码文件夹
注意:选择的路径文件名可以包含字母、数字和下划线(_)。避免使用特殊字符、空格或其他非法字符,以确保文件名在各种操作系统上的兼容性。
创建代码文件
按照箭头所示顺序点击,并为其命名。
配置编译
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文件
尝试编译并调试Hello world文件
开始调试
若出现“调试失败”,请检查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博客
最后的最后,如果有错误或遗漏的地方,欢迎评论区大佬批评指正。
✿✿ヽ(°▽°)ノ✿ ✿✿ヽ(°▽°)ノ✿ ✿✿ヽ(°▽°)ノ✿ ✿✿ヽ(°▽°)ノ✿