VS Code Config Helper v4

Linux 配置说明

重要说明

WSL/Ubuntu 下中文字体安装方法:

  1. 修改 /etc/locale.gen,使得 zh_CN.UTF-8 UTF-8 行可用。
  2. 执行以下命令:
      sudo locale-gen
      sudo apt install fonts-wqy-microhei ttf-wqy-zenhei > language-pack-zh-hans language-pack-gnome-zh-hans > language-pack-kde-zh-hans manpages-zh
    
  3. 在 Windows 中重启 WSL 实例:
      wsl --shutdown
    

第一步:下载 VS Code

前往官方网站获取 Linux 版 VS Code 并安装。

第二步:获取本软件

直接在网站首页下载即可。Linux 版共有两种下载:

  1. (默认)AppImage。体积较大,但保证可以在各大发行版运行。
  2. 可执行文件。体积较小,但可能需要外部链接库才能正常运行。

下载完成后,请赋予其可执行权限。

chmod +x ./vscch_blah_blah_blah.AppImage

第三步:开始配置

双击运行,或在终端启动本程序。你将看到如下界面:

1661773006170

如果你无法正常启动,可以先尝试更新系统依赖(如 apt update 和 apt upgrade )。如问题仍存在,则可改用 CLI。

点击“下一步”以继续。

VS Code 选择

1661773149100

如果你已经正确安装了 VS Code,则此处将显示你的 VS Code 安装路径,点击“下一步”即可。如果你不能点击下一步,则表明工具没有检测到已安装的 VS Code。这可能是由于你没有将 VS Code 所在路径添加到 PATH 环境变量导致的(比如从源码构建)。你可以在这里手动输入其路径,或者重新从官网安装。

编译器选择

1661773542047

如果你已经安装了 GCC 编译器,则这里将显示它的路径和版本信息,点击“下一步”即可。如果你希望使用 LLVM/Clang,你可以点击右上角的“更改编译器类型”,并选择“LLVM”。

如果你还没有安装 GCC 或者 LLVM,建议你使用该 Linux 发行版的包管理工具获取它们(比如 sudo apt install g++)。安装好后,重新运行本工具(保证 PATH 环境变量可被正确读取)以使用它们。

1661773720812

此外,如果你想使用从源码编译的、尚未安装的编译器;或者其它的编译器版本(如 g++-9),你可以将该编译器的路径输入到文本框中。(点击表格下方的“或者,使用新的编译器”按钮即可跳转到文本框界面。)

工作文件夹选择

1661774148252

输入任意的工作文件夹路径,你的代码以后应当存放在该文件夹内。若该文件夹尚未创建,则工具会自动创建它。点击“下一步”以继续。

调整配置选项

一般保持默认即可,具体可参考配置选项说明。点击“下一步”后,耐心等待工具完成配置流程。

第四步:测试

如果配置选项中勾选了“配置完成后自动启动 VS Code”,且未禁用“生成测试文件”,则工具将自动为你打开工作文件夹,并显示工具生成的测试代码。

如果你第一次使用 LLVM/Clang 编译器,CodeLLDB 扩展会启动并下载必要组件。请耐心等待其完成。如无法下载,可尝试切换网络环境。

1661774628024

在该页面按下运行快捷键(默认为 F6),即可编译并运行该代码。

1661774925069

此时优先弹出注册在 X 窗口系统中的终端模拟器(x-terminal-emulator)。在 WSL 下,还会尝试使用宿主系统弹窗。如果运行失败,你可以将具体问题反馈到 pause-console 仓库。

在该页面按下调试快捷键(默认为 F5),即可调试该代码。调试前建议打断点。