VSCode配置总结笔记
1   下载及安装VSCode
- 下载:VSCode System Installer
- 安装:默认路径安装,选项额外添选上下文菜单(文件和目录)
镜像加速下载的方法:将下载链接URL中的stable
之前的字符全部改为https://vscode.cdn.azure.cn/
即可。
2   配置远程主机SSH连接使用VSCode
- 安装
Remote - SSH
扩展插件。 - 点击这个扩展插件图标,点击设置SSH配置文件。配置方法见管理多个SSH远程服务器
- 首次连接,VSCode会在远程服务器上安装VSCode Server,安装完成后,VSCode会自动连接远程服务器。可以大致一窥对应的VSCode Server文件构成(如果是普通账户,路径前缀是
/home/yourname
,对应$HOME
环境变量):
1 | # 2901c5ac6db8a986a5666c3af51ff804d05af0d4为vscode当前构建版本的commit id |
- 后续如果有版本变动升级,请确保服务器和本地都及时更新,不然本地新版本连过去,会一直重复部署新的VSCode Server的操作。
- 服务器和本地的VSCode的扩展插件是分开管理的。
3   配置C/C++开发环境
3.1   MSVC CL编译器的安装和环境设置
- 下载(
CMake
和Ninja
可以不用单独下载安装,MSVC CL
编译器的Visual Studio Installer
管理器可以统一管理下载和更新)- MSVC CL编译器(Visual Studio 2022 生成工具),
所有下载
->用于 Visual Studio 的工具
->Visual Studio 2022 生成工具
。 CMakeNinja
- MSVC CL编译器(Visual Studio 2022 生成工具),
- 安装「Visual Studio 2022 生成工具」,然后勾选对应包下载安装
- 工作负荷:使用C++的桌面开发
- MSVC v143 - VS 2022 C++ x64/x86生成工具(最新)
- Windows 11 SDK (10.0.26100.0):建议选择最新的系统版本号
- 用于 Windows 的 C++ CMake 工具(包含CMake和Ninja)
- 单个组件
- 对 LLVM(clang-cl)工具集的 MSBuild 支持
- 适用于 Windows 的C++ Clang 编译器(18.1.8)
- MSVC v143 - VS 2022 C++ x64/x86 Spectre 缓解库(最新)
- 工作负荷:使用C++的桌面开发
- 分别添加程序路径到系统环境变量
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
- MSVC CL编译器路径:
- 拷贝
.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使用
- VSCode安装好Codeium扩展插件。
- 左下角,点击Codeium Auth登录按钮,首先插件会弹窗请求跳转到网页输入帐号登录。
- 直接关闭打开的网页,点击右下角「在线帐号登录」的cancel按钮。
- 之后插件会弹窗请求跳转到网页输入帐号登录,这个在线网址则是获取「Provide Authentication Token」。(如果已经提前获取到token,这里可以不登录网页帐号,直接关闭网页)
- 最后通过
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.