在Ubuntu上安装通义灵码需先安装build-essential、git、python3-pip等基础工具链,再通过APT或.deb安装VSCode,最后在VSCode中安装TONGYI Lingma插件并登录阿里云账号;内网环境需配置HTTP代理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Ubuntu系统上安装通义灵码并完成Linux开发环境基础配置,需先确保系统具备Python、Git、编译工具链等必要组件,再单独安装通义灵码插件——它不以独立程序形式安装,而是作为VSCode或JetBrains IDE的扩展运行,因此必须先配好IDE依赖环境,否则插件无法启动或功能异常。
安装基础开发工具链
打开终端,一次性安装gcc、g++、make、git、curl和wget等核心工具:
sudo apt update && sudo apt install -y build-essential git curl wget python3-pip python3-venv
这一步不可跳过。build-essential包含gcc、g++和make,是后续所有C/C++项目编译、以及通义灵码本地代码分析功能(如符号解析、AST生成)的底层依赖。若只装gcc不装g++,部分C++项目上下文理解会失败;若未装python3-venv,VSCode中Python工作区激活时可能报错“venv not found”。
验证Git是否正常:git --version。若提示command not found,请重装git并检查PATH是否含/usr/bin。
配置VSCode并安装通义灵码插件
方法一:通过APT安装官方VSCode(推荐)
下载微软GPG密钥并添加仓库:
wget -qO - https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > /usr/share/keyrings/microsoft-archive-keyring.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/microsoft-archive-keyring.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list
sudo apt update && sudo apt install -y code
方法二:直接下载.deb包(网络受限时用)
curl -fsSL https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64 -o code-stable.deb && sudo apt install -y ./code-stable.deb
【注意】安装后不要立即启动VSCode,先执行下一步设置代理或登录环境。
启动VSCode:code --no-sandbox(首次运行加--no-sandbox可避免沙箱权限冲突)→ Ctrl+Shift+X打开扩展面板 → 搜索“TONGYI Lingma” → 点击安装 → 安装完成后重启VSCode。
配置通义灵码登录与网络访问
第一步:确认系统时间准确
通义灵码API调用依赖HTTPS证书校验,若Ubuntu系统时间偏差超5分钟,将出现“network error”或“login failed”提示。执行以下命令同步时间:
sudo timedatectl set-ntp true && sudo systemctl restart systemd-timesyncd
第二步:登录阿里云账号
点击左侧通义灵码图标 → “立即登录” → 自动跳转至浏览器阿里云扫码页 → 扫码完成授权 → VSCode右下角出现“已登录”提示。
第三步:(仅限企业内网/无外网Ubuntu)配置HTTP代理
若服务器无法直连 dashscope.aliyuncs.com,在VSCode设置中搜索“http.proxy”,填入公司代理地址,例如 http://proxy.internal:8080;同时勾选“http.proxyStrictSSL”设为false(因内网代理常使用自签名证书)。
验证:在任意.py文件中选中一段代码 → 右键 → “Ask Tongyi Lingma” → 输入“解释这段代码” → 出现结构化回答即成功。


















