在Ubuntu系统中为VSCode配置通义灵码插件，只需几步即可完成——但前提是VSCode版本不低于1.70.x，否则插件无法正常安装。先检查环境，再安装插件，最后登录激活，每个环节都不能跳过。

首先确认VSCode版本。打开终端，执行 code --version，如果提示“command not found”，说明VSCode的PATH未正确配置。常见做法是将 /usr/share/code/bin 添加到环境变量，或者直接在VSCode菜单中选择“Shell Command: Install 'code' command in PATH”。若版本号低于1.70.x，则需要卸载旧版，前往官网下载最新的.deb包，然后运行 sudo apt install ./code_*.deb 完成安装。

通过VSCode扩展市场安装通义灵码

这一步最为便捷。启动VSCode后，点击左侧活动栏的扩展图标（或使用快捷键 Ctrl+Shift+X），在搜索框中输入 TONGYI Lingma，找到发布者为Alibaba Cloud的插件，点击安装即可。安装完成后无需重启，但首次使用时需点击左下角的通义灵码图标，或按下 Ctrl+Shift+P 输入“Lingma: Toggle Sidebar”来唤醒插件面板。

手动安装插件（离线环境或市场不可用时）

当网络状况不佳或扩展市场出现异常时，离线安装是一种可靠的备用方案。具体有两种操作方法：

一种是从JetBrains插件仓库下载 .vsix 文件（注意不是.zip或.jar格式），然后在VSCode扩展视图中点击右上角“…” → “从VSIX安装”。另一种是使用命令行安装，适合批量部署场景：code --install-extension /path/to/tongyi-lingma-*.vsix，请将路径替换为实际文件所在目录。需注意，执行此命令前应确保VSCode未运行，否则会提示错误 【Extension installation failed: EACCES】。

登录并激活通义灵码服务

插件安装完成只是第一步，仍需登录才能正常使用。点击VSCode左侧的通义灵码图标进入面板，点击“立即登录”，浏览器将自动跳转至阿里云登录页面。使用你的阿里云账号扫码或密码登录，完成授权后返回VSCode，等待状态栏右下角显示“已登录”及用户头像，即表示激活成功。

有一个常见问题：如果登录后始终提示“未授权”，多半是系统时间不准确。Ubuntu默认可能未开启NTP时间同步，执行 sudo timedatectl set-ntp true 并重启网络服务即可解决。