VSCode插件多版本共存靠目录隔离，非Git分支；各版本解压至~/.vscode/extensions/独立子目录，启动时仅加载当前激活版本，旧版残留易致报错。
VSCode插件多版本共存靠目录隔离，不是Git分支
VSCode插件没有“分支”概念，所谓“多版本共存”，本质是多个语义化版本（如ms-python.python-2024.8.1和ms-python.python-2024.12.0）被并行解压到~/.vscode/extensions/下的独立子目录中。VSCode启动时只加载当前激活的那个版本，其余版本静默驻留，互不干扰。
常见错误现象：Install Another Version…点开后列表为空，或卸载旧版后发现新版本仍报错——其实是旧版目录没删干净，残留配置或缓存仍在起作用。
- 插件更新不会覆盖旧目录，而是新建带完整版本号的文件夹；你手动删除旧版目录（如
ms-python.python-2023.10.1）是安全的，但别删错名字相似的其他插件目录 - “切换版本”不是点击切换，而是通过右键插件 →
Install Another Version…回退，或先卸载再手动安装指定.vsix - 插件本身不读
.git或main/dev分支，GitLens等插件的分支视图仅作用于你打开的代码仓库，与插件自身无关
Node.js多版本切换必须终端+调试器双确认
VSCode不管理Node版本，真正生效的是你在终端里执行的nvm use；但调试器（F5）完全不继承终端环境，所以终端node -v正确 ≠ F5用对版本。
容易踩的坑：terminal.integrated.inheritEnv设为true后没彻底退出VSCode重开，导致nvm命令在集成终端里仍不可用；或者launch.json里漏写"runtimeExecutable": "${env:NVM_BIN}/node"，结果F5始终调用系统默认node。
- 验证是否就绪：新开集成终端，运行
which nvm和nvm current，两者都应有输出 -
echo $NVM_BIN必须返回有效路径，否则${env:NVM_BIN}在launch.json中会展开为空，F5直接报Cannot resolve runtimeExecutable - 不要硬编码路径（如
/Users/x/.nvm/versions/node/v18.19.0/bin/node），换机器或重装nvm就失效；Windows用户用nvm-windows时更得注意：NVM_BIN不存在，只能用${env:USERPROFILE}\.nvm\v18.19.0\node.exe这类结构，但同样不推荐跨环境复用
Python解释器切换本质是路径选择，不是改设置项
VSCode切Python版本，就是换解释器可执行文件路径。选错python路径，补全、调试、终端运行都会出问题；手动改settings.json里的python.defaultInterpreterPath不仅易被工作区设置覆盖，还可能指向一个根本不存在或没装ipykernel的环境。
最常被忽略的一点：VSCode会记住上一个工作区的解释器偏好，新开项目时它默默沿用旧路径——哪怕那个Python根本没装在这个新项目里。
- 必须用命令面板：
Ctrl+Shift+P→ 输入Python: Select Interpreter触发，而不是去设置里填路径 - 选完后右下角显示的路径（如
~/miniconda3/envs/py39/bin/python）要能ls到，且该路径下python -c "import sys; print(sys.version)"能正常输出 - conda环境需额外装
ipykernel：conda activate myenv && pip install ipykernel && python -m ipykernel install --user --name myenv --display-name "Python (myenv)"，漏掉--user会导致VSCode找不到kernel - pyenv用户必须从终端启动VSCode（如macOS下
code .），双击图标启动无法加载.zshrc里的pyenv初始化，which python会指向系统Python而非pyenv管理的版本
MSVC编译器多版本共存依赖三重环境上下文解耦
VSCode里MSVC的cl.exe、IntelliSense头文件解析、CMake构建，三者加载环境变量完全独立——改了c_cpp_properties.json里的compilerPath，不代表CMake就能找到对应toolset；状态栏显示msvc-x64也不代表stdio.h一定能被include。
典型症状：where cl.exe在Developer PowerShell里能定位，但在VSCode集成终端里报command not found；或CMake configure失败提示msvc toolset 'v143' not found。
- IntelliSense依赖
c_cpp_properties.json中的intelliSenseMode和vcpkgRoot等字段，必须与compilerPath指向的MSVC版本匹配，否则头文件路径错配 - CMake Tools的kit探测依赖
visualStudioVersion和vsInstallDir环境变量，不能只靠PATH；建议在cmake.configureEnvironment中显式传入 - 硬编码
compilerPath（如c:/program files/microsoft visual studio/2022/community/vc/tools/msvc/14.39.33519/bin/hostx64/x64/cl.exe）风险极高——Visual Studio升级后该路径立刻失效，且不同机器的14.39.33519数字完全不同
