VSCode配置总结笔记

1   下载及安装VSCode

• 下载：VSCode System Installer
• 安装：默认路径安装，选项额外添选上下文菜单（文件和目录）

镜像加速下载的方法：将下载链接URL中的stable之前的字符全部改为https://vscode.cdn.azure.cn/即可。

2   配置远程主机SSH连接使用VSCode

• 使用https://aka.ms/install-vscode-server/setup.sh的安装教程已经过时，这个链接甚至都被重定向成https://vscodeserverlauncher.blob.core.windows.net/builds/setup-scripts/setup.sh这种主机失联的域名。这篇VSCode官方博文教程-The Visual Studio Code Server已过时。
• 如果想使用远程隧道（tunnel）访问连接使用VSCode，参考这篇官方博文Remote Development Even Better。
• 根据VSC remote leaves behind old server versions and extensions data at each VSC update这篇issue的信息，VS Code Server正常会在服务器上保留最近5个版本的副本。可以自行登录服务器查看/root/.vscode-server/cli/servers有多少个副本文件夹。

1. 安装Remote - SSH扩展插件。
2. 点击这个扩展插件图标，点击设置SSH配置文件。配置方法见管理多个SSH远程服务器
3. 首次连接，VSCode会在远程服务器上安装VSCode Server，安装完成后，VSCode会自动连接远程服务器。可以大致一窥对应的VSCode Server文件构成（如果是普通账户，路径前缀是/home/yourname，对应$HOME环境变量）：

# 2901c5ac6db8a986a5666c3af51ff804d05af0d4为vscode当前构建版本的commit id
/root/.vscode-server/cli/servers/Stable-2901c5ac6db8a986a5666c3af51ff804d05af0d4/server/bin
/root/.vscode-server/cli/servers/Stable-2901c5ac6db8a986a5666c3af51ff804d05af0d4/server/extensions
/root/.vscode-server/cli/servers/Stable-2901c5ac6db8a986a5666c3af51ff804d05af0d4/server/node_modules
/root/.vscode-server/cli/servers/Stable-2901c5ac6db8a986a5666c3af51ff804d05af0d4/server/out
/root/.vscode-server/data/
/root/.vscode-server/extensions/
/root/.vscode-server/code-2901c5ac6db8a986a5666c3af51ff804d05af0d4
...

4. 后续如果有版本变动升级，请确保服务器和本地都及时更新，不然本地新版本连过去，会一直重复部署新的VSCode Server的操作。
5. 服务器和本地的VSCode的扩展插件是分开管理的。

假设如果因为种种原因需要手动下载VS Code Server程序（例如因为网络问题，一直卡在下载文件，文件占用一直是零字节），也有其他方法能实现：

1. 先下载vscode-server-linux-x64.tar.gz压缩包。

https://update.code.visualstudio.com/commit:${commit_id}/server-linux-x64/stable（注意把:${commit_id}替换成对应的Commit ID）

2. 上传至/root/.vscode-server/cli/servers/Stable-${commit_id}/路径下，直接解压到文件夹vscode-server-linux-x64，然后将vscode-server-linux-x64文件夹重命名server。这里参考上述的VSCode Server文件构成即可。
3. 之后就可以尝试本地连接远程服务器了。

远程VSCode所支持的SSH server服务器主机类型：
Remote SSH host: A running SSH server on:

• x86_64 Debian 8+, Ubuntu 16.04+, CentOS / RHEL 7+.
• ARMv7l (AArch32) Raspberry Pi OS (previously called Raspbian) Stretch/9+ (32-bit).
• ARMv8l (AArch64) Ubuntu 18.04+ (64-bit).
• Windows 10 / Server 2016/2019 (1803+) using the official OpenSSH Server.
• macOS 10.14+ (Mojave) SSH hosts with Remote Login enabled.
• 1 GB RAM is required for remote hosts, but at least 2 GB RAM and a 2-core CPU is recommended.

3   配置C/C++开发环境

3.1   MSVC CL编译器的安装和环境设置

1. 下载（CMake和Ninja可以不用单独下载安装，MSVC CL编译器的Visual Studio Installer管理器可以统一管理下载和更新）
   • MSVC CL编译器（Visual Studio 2022 生成工具），所有下载->用于 Visual Studio 的工具->Visual Studio 2022 生成工具。
   • CMake
   • Ninja
2. 安装「Visual Studio 2022 生成工具」，然后勾选对应包下载安装
   1. 工作负荷：使用C++的桌面开发
      • MSVC v143 - VS 2022 C++ x64/x86生成工具(最新)
      • Windows 11 SDK (10.0.26100.0)：建议选择最新的系统版本号
      • 用于 Windows 的 C++ CMake 工具（包含CMake和Ninja）
   2. 单个组件
      • 对 LLVM(clang-cl)工具集的 MSBuild 支持
      • 适用于 Windows 的C++ Clang 编译器(18.1.8)
      • MSVC v143 - VS 2022 C++ x64/x86 Spectre 缓解库（最新）
3. 分别添加程序路径到系统环境变量Path
   • MSVC CL编译器路径：C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.42.34433\bin\Hostx64\x64
   • LLVM CLANG编译器路径：C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\Llvm\x64\bin
   • CMake路径：C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin
   • Ninja路径：C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\Common7\IDE\CommonExtensions\Microsoft\CMake\Ninja
4. 拷贝.vscode配置文件夹

3.2   更新MSVC后找不到CL命令

使用Visual Studio Installer更新MSVC后，编译器版本号可能会变更，如果在终端运行cl命令后提示找不到程序，需要手动更新两处地方的CL编译器路径：

• 系统环境变量Path
• .vscode配置文件夹中的c_cpp_properties.json

4   VSCode源代码管理

对于新建的空仓库，使用clone命令克隆仓库后，第一次用vs code进行commit时，若使用「同步更改」命令提示说找不到远程仓库时，可以直接使用「推送到」命令。

5   Codeium(Windsurf)扩展插件的帐号token获取及使用

一般直接通过Codeium Auth登录帐号即可使用扩展插件。

5.1   token获取

如果不想登录帐号，而是想要通过ctrl+shift+p执行Codeium: Provide Authentication Token命令输入token的话。首先需要获取token，获取方式：

• 方式一：官网直链获取（此直链是会提示关联vim扩展，但token都是通用的，同样适用于VSCode的扩展），直接在该网址中登录帐号即可获取「Provide Authentication Token」
• 方式二：参考token使用的1-4步骤。

5.2   token使用

1. VSCode安装好Codeium扩展插件。
2. 左下角，点击Codeium Auth登录按钮，首先插件会弹窗请求跳转到网页输入帐号登录。
3. 直接关闭打开的网页，点击右下角「在线帐号登录」的cancel按钮。
4. 之后插件会弹窗请求跳转到网页输入帐号登录，这个在线网址则是获取「Provide Authentication Token」。（如果已经提前获取到token，这里可以不登录网页帐号，直接关闭网页）
5. 最后通过ctrl+shift+p执行Codeium: Provide Authentication Token命令输入token即可正常登录。

6   拓展插件

6.1   LaTeX-Workshop报错提示command 'latex-workshop.onEnterKey' not found

问题现象：在tex文件中使用Enter键会出现报错信息，提示command 'latex-workshop.onEnterKey' not found，只有Ctrl+Enter键才能正常输入回车。

解决方案：卸载LaTeX-Workshop扩展插件，关闭VSCode程序，确保VSCode正常移除插件的缓存文件。然后重新打开VSCode，重新安装LaTeX-Workshop。

7   参考文献

[1] [Question] How can I get codeium auth token[EB/OL]. https://github.com/Exafunction/codeium.vim/issues/150.
[2] VsCode下载，使用国内镜像秒下载[EB/OL]. https://blog.csdn.net/bielaiwuyang1999/article/details/117814237.
[3] Remote Development using SSH[EB/OL]. https://code.visualstudio.com/docs/remote/ssh.
[4] VS Code Server的离线安装过程[EB/OL]. https://zhuanlan.zhihu.com/p/294933020.
[5] 使用 vscode + Remote-SSH 插件 + vscode-server 进行远程开发[EB/OL]. https://zhuanlan.zhihu.com/p/493050003.
[6] 最香远程开发解决方案！手把手教你配置VS Code远程开发工具，工作效率提升N倍[EB/OL]. https://www.cnblogs.com/NanoDragon/p/12899430.html.
[7] Visual Studio Code Server[EB/OL]. https://code.visualstudio.com/docs/remote/vscode-server.