需手动升级通义灵码插件：vs code通过vsix文件覆盖安装并重启，jetbrains ide则替换plugins目录下tongyi-lingma子文件夹中的jar包，确保version≥v3.12.0且模型列表含deepseek-v3/r1。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
通义灵码插件在IDE中显示“已安装”但功能陈旧、模型选项缺失或无法调用DeepSeek-V3/R1等新能力，说明插件未真正更新到最新版，需绕过自动更新机制手动升级。
确认当前版本是否滞后
打开IDE（如IntelliJ IDEA或PyCharm），进入 File → Settings → Plugins（Windows/Linux）或 PyCharm → Preferences → Plugins（macOS），在已安装插件列表中找到“TONGYI Lingma”。【注意：不要只看右下角状态栏图标或右侧工具栏图标——这些可能仍显示旧版UI】。点击插件条目，在右侧详情面板查看“Version”字段：若版本号低于 v3.12.0（截至2026年5月的最新稳定版），则必须手动升级。
版本号为 v3.8.x 或更早，基本可判定已落后至少3个大版本，自动更新失败概率极高。
VS Code：从VSIX文件强制重装
方法一：直接覆盖安装（推荐）
① 访问官方下载页 https://tongyi.aliyun.com/lingma/download ，选择“VS Code”平台，下载最新 .vsix 文件（文件名含 tongyilingma-*.vsix）；
② 在VS Code中按 Ctrl+Shift+X 打开扩展视图 → 点击右上角“…” → 选择“Install from VSIX…” → 选中刚下载的文件；
③ 安装完成后，VS Code会提示“Extension installed successfully”，此时必须关闭并重启整个VS Code窗口（不是仅重载窗口），否则插件仍运行旧逻辑。
方法二：彻底清除后重装（适用于登录态异常或模型切换失效）
先卸载：在扩展市场中找到“通义灵码”→点击“Uninstall”→确认；再清缓存：删除 ~/.vscode/extensions/tongyilingma*（Linux/macOS）或 %USERPROFILE%\.vscode\extensions\tongyilingma*（Windows）下的全部残留文件夹；最后执行方法一的步骤①②③。
通义灵码 Linux版是阿里云推出的一款AI智能编码助手，专为Linux开发者设计。它支持在Linux操作系统下的JetBrains IDEs、Visual Studio Code等主流集成开发环境中运行。该工具基于通义大模型，提供代码智能生成、实时续写、单元测试生成、代码优化以及研发智能问答等功能，旨在帮助Linux用户在编码过程中提升效率。
JetBrains IDE：离线安装包替换法
第一步：关闭IDE
确保IntelliJ IDEA、PyCharm等目标IDE已完全退出，任务管理器中无 java.exe 或 jetbrains* 进程残留。
第二步：定位插件安装目录
Windows路径示例：C:\Users\[用户名]\AppData\Roaming\JetBrains\[IDE代号]\plugins\TONGYI-Lingma；
macOS路径示例：~/Library/Caches/JetBrains/[IDE代号]/plugins/TONGYI-Lingma；
Linux路径示例：~/.cache/JetBrains/[IDE代号]/plugins/TONGYI-Lingma。【关键：必须进入 plugins 目录下的 TONGYI-Lingma 子文件夹，而非上级 plugins 文件夹】
第三步：替换核心jar包
从官网下载页获取最新离线包（ZIP格式），解压后找到 tongyi-lingma-*.jar 文件（通常在 lib/ 子目录下）；将该jar文件复制粘贴，**覆盖原目录中同名jar文件**；若原目录存在多个jar（如 tongyi-lingma-3.8.2.jar 和 tongyi-lingma-core-3.8.2.jar），需一并替换为新版本对应文件。
第四步：启动并验证
重新打开IDE → 进入 Settings → Plugins → 查看“TONGYI Lingma”详情页 → Version应显示最新号；点击右下角通义灵码图标 → 在对话框左上角点击模型下拉菜单 → 若能看到 Qwen2.5 / DeepSeek-V3 / R1 选项，则升级成功。
