VS Code 升级华为云码道插件后连不上：我踩过的三个坑与回退办法

最近在准备比赛、每天在华为云上做实验的这段时间，我把 VS Code 里的华为云码道（CodeArts）插件顺手升级了一次。升级本身只花了一两分钟，但升级后插件却连不上了：代码补全没有反应，问答对话一直转圈，状态栏也显示未连接。那天我折腾了快一个小时，才把三个坑逐一排掉。把经过记下来，希望能帮后来的人少走弯路。

先说结论

升级插件不是点一下更新就完事。升级前先备份配置，升级后按“版本—登录—配置”的顺序验证，出了问题一次只改一个地方，这样才能定位到底是哪一步坏了。

坑一：新旧版本残留，插件与 VS Code 版本不匹配

症状：升级后插件图标还在，点开却没有任何响应，补全功能像是被关掉了一样，输出日志里出现版本相关的提示。

我一开始以为是网络问题，反复开关代理、重启编辑器都没用。后来才发现，是旧版插件没有卸干净，新版装上去后两份文件混在一起；另外新版对 VS Code 的最低版本也有要求，旧编辑器配新插件本身就容易出问题。

解决办法：

1. 在扩展列表里先把码道插件完整卸载，不要直接覆盖安装。
2. 完全退出 VS Code 再重新打开，确认扩展列表里已经没有它。
3. 再从市场安装新版，装完重启一次编辑器。
4. 安装前先看一眼插件页面的版本要求，编辑器太旧就先升级编辑器。

坑二：登录态失效，被当成“没登录”

症状：插件反复提示要登录，点登录后浏览器里明明已经登录了华为云，回到 VS Code 还是未连接。换账号、反复点登录都没有用。

这个坑最容易让人走错方向。我一开始怀疑是不是登错了账号，后来才想明白：浏览器里的登录态和插件里缓存的凭证不是一回事。升级后插件保存的旧凭证失效了，它不会自动用浏览器的登录态续上，必须在插件里重新走一次登录。

解决办法：

1. 在插件设置里先退出登录，清理掉旧的登录缓存，再重新登录一次。
2. 登录时确认当前是自己要用的账号，不要在多个账号之间来回切换，切换一次就容易把凭证搞乱。
3. 登录成功后先做一次最小验证：问一个简单的问题，比如让它解释一段很短的代码，能正常返回就说明登录真的通了。

坑三：工作区配置被覆盖，自定义设置丢了

症状：插件终于连上了，但原来配好的语言、模型选择和快捷键都不见了，问答的回答风格也变了，像是回到了默认状态。

这是升级时最容易忽略的一点。升级本身不会故意删配置，但如果升级过程中工作区配置被覆盖，或者自己着急把旧的 settings.json 整份拷回来，就很容易把新版不认的旧字段也带回来，反而让插件工作不正常。

解决办法：

1. 升级前先备份 settings.json 和工作区的 .vscode 文件夹，单独存一份。
2. 升级后先用默认配置跑通，再逐项把备份里的自定义项加回来，一次加一项。
3. 遇到不确定的配置项，先看插件当时的设置说明，不要整份覆盖。

升级后用三招验证

我现在每次升级完都会做这三件事，全部通过才算升级完成：

1. 新建一个小文件，写一段简单的函数，看代码补全是否正常出现。
2. 在对话里问一个简单问题，看是否能正常返回完整回答。
3. 完全重启 VS Code 再测一次，确认不是“重启一次才好”的假象。

实在不行，怎么回退

如果新版怎么调都用不了，不要硬撑。先卸载新版，装回上一个能用的版本，恢复备份的配置，保证先能正常干活，再等下一个版本发布后换一台机器或者换个时间重新升级。回退时记住一次只改一个地方：要么改版本，要么改配置，不要两个一起改，否则出了问题也不知道是哪一个引起的。

总结

插件升级踩坑的教训其实就一句话：先备份，再升级，升级后按顺序验证。希望这篇记录能帮你把升级的半小时，变成十分钟就能搞定的事。