常见问题

1. 提示“通义灵码启动中”怎么办？

如果在使用通义灵码时看到“灵码启动中”的提示，您可以按照以下步骤逐一排查并解决问题。

1. 检查插件版本与运行环境：

   • 确保您已将灵码插件升级至最新版本，并确认您的操作系统和系统架构支持灵码运行。

   • 如果您使用的是 Jetbrains IDE，请进行以下检查：保证 IDE 的堆内存大小足够。操作步骤：依次点击 File -> Invalidate Caches，清理缓存后重启 IDE。

2. 网络连接与代理配置：

   • 确保以下地址可以正常访问。如果无法访问，请联系公司 IT 部门将其加入白名单：

     • 执行命令：

       curl https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping

       返回值应为 pong。

     • 执行命令：

       curl -I https://devops.aliyun.com

       返回状态码应为 302。

   • 如果公司防火墙限制且无法加白名单，需手动配置代理地址（具体地址请联系公司 IT 提供）：

     代理格式：http(s)://用户名:密码@代理服务器地址:端口

     • 如果域名保存未生效，可手动修改配置文件：

       路径：C:\Users\用户名\AppData\Local\.lingma\config.json

       修改 http_proxy 字段后，结束灵码进程并重启。

   • 清理 DNS 缓存：

     • Windows：执行命令 ipconfig /flushdns

     • macOS：执行命令 sudo killall -HUP mDNSResponder

3. 清理本地缓存并重新启动 IDE。以管理员权限启动 IDE，打开一个非空项目文件夹后，尝试以下操作：

   1. 结束 Lingma 进程。

   2. 删除 .lingma 目录：

      1. Windows：路径为 C:\用户\[用户名]\.lingma

      2. macOS：路径为 ~/.lingma

   3. 完成上述操作后，重新启动 IDE。

4. 手动启动 Lingma 服务。如果问题仍未解决，可尝试手动启动 Lingma 服务：

   进入目录：.lingma/bin/x.x.x/CPU架构_64_系统/

   执行命令：

   Lingma.exe start

   等待启动成功后，重新点击登录按钮。

5. 解决“不兼容的程序”问题：如果在 Windows 上收到“不兼容的程序”提示，可能是由于解压不完整导致的。解决方法如下：

   • 点击右下角的灵码图标，选择 高级设置。

   • 修改解压路径为非 C 盘的其他路径，并确保路径以空文件夹结尾。

   • 重启 IDE 后重试。

   说明

   注意：部分公司内网会对二进制程序进行加锁，导致无法运行。

6. 防火墙或安全软件限制：如果 Lingma 进程仍然无法正常启动或登录无反应，可能是因为防火墙或公司安全软件限制了运行。请按以下步骤操作：

   • 添加防火墙白名单：

     打开控制面板 -> 系统和安全 -> Windows Defender 防火墙 -> 允许的应用，将 Lingma 加入白名单。

   • 在公司安全软件中添加进程文件白名单：

     路径示例：C:\Users\xxx\.lingma\bin\2.1.x\x86_64_windows\lingma.exe

     （请联系公司 IT 支持人员协助完成。）

   • 如果通义灵码的 JetBrains 插件版本为 2.1.4 或更高版本，您可以按下图所示切换到 stdio 模式：

2. 显示登录失败、无权限怎么办？

当从 IDE 客户端单击登录后，会前往浏览器登录阿里云，出现登录失败或账号无权限，可能有 2 种情况：

• 当登录参数失效时，可能会出现登录失败的情况，可稍后在 IDE 客户端单击登录，再次尝试登录。

• 当所在的网络环境需要使用代理访问公网时，可能会提示登录失败或账号无权限，需将通义灵码升级到最新版本，确保以下 host 可访问，如发现网络不通，需要添加白名单，可参考网络代理配置解决问题。

curl https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping
curl -I https://devops.aliyun.com

• 配置完成后从进程管理器里找到 Lingma 进程，结束进程后，返回 IDE 重新登录。

3. Remote SSH、WSL 等进行远程开发时，如何登录通义灵码？

在使用 VS Code、JetBrains IDEs 上连接远程服务器进行开发时，可使用阿里云账号的 AK/SK 进行登录后使用通义灵码。查看详细方式：安装和登录。

4. Web IDE 中可以使用通义灵码吗？

可通过阿里云账号的 AK/SK 进行登录后使用，安装和登录。

5. 如何配置网络代理？

通义灵码支持 HTTP、HTTPS、Socks5 网络代理配置，可在插件设置页进行配置，具体操作参考：网络代理配置。

6. 如何测试网络连通性？

可以尝试在 Terminal 中输入以下命令，如果返回 pong，则大概率可连通至通义灵码服务端。

curl https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping
curl -I https://devops.aliyun.com

1. 通义灵码如何收费？

面向个人开发者提供个人基础版、个人专业版，个人专业版当前为限时免费使用阶段，所有用户均可享受个人专业版服务，限免期结束后，也会对所有开发者免费提供个人基础版服务，限免周期暂未确定，敬请关注后续产品公告。

面向企业客户提供企业标准版、企业专属版，企业版计费信息可参考：计费说明。

1. 使用什么账号进行登录体验通义灵码？

需要使用阿里云账号登录后体验通义灵码，在 IDE 客户端的通义灵码助手窗口中单击登录按钮，即可完成阿里云登录。前往注册阿里云账号。

2. RAM 用户可以体验通义灵码吗？

RAM 用户在其阿里云主账号尚未开通企业标准版的情况下，可以个人开发者身份使用通义灵码，在 IDE 客户端中单击登录，切换到 RAM 用户登录页面，完成登录后即可体验通义灵码。

3. 企业如何体验通义灵码？

如果需要体验企业版，可参考企业标准版快速入门教程。

1. JetBrains IDEs 版本兼容是多少？

目前 JetBrains IDEs 兼容 2020.3（203.x）及以上，包含 IntelliJ IDEA、PyCharm、GoLand、WebStorm 等 JetBrains IDEs。

2. Visual Studio Code 版本兼容是多少？

目前 Visual Studio Code 兼容 1.68.0 及以上。

3. Visual Studio 2022 版本兼容是多少？

目前兼容 Visual Studio 2022 17.3.0 及以上版本。

4. 支持操作系统版本有哪些？

• JetBrains IDEs 兼容的操作系统：Windows 7 及以上、macOS、Linux。

• Visual Studio Code 兼容的操作系统：Windows 7 及以上、macOS、Linux

• Visual Studio 2022 兼容的操作系统：Windows 10 及以上

5. 支持哪些编程语言？

全面覆盖主流编程语言，在 Java、Python、Go、JavaScript、TypeScript、C/C++、C# 编码场景表现更优。

1. 通义灵码会存储我的代码数据吗？

我们不会存储您的代码数据：

• 代码补全时，我们需要获取您的代码上下文信息以完成补全，但上下文信息不会被存储或用于其他任何目的，该等数据完全由您所有及控制。

• 研发智能问答时，我们仅会在您点踩/点赞后，仅针对聊天记录（不包含代码），并将数据进行脱敏、去标识化处理后，用于算法的升级、迭代。

更多隐私政策，可前往灵码隐私政策。

2. 通义灵码的训练数据包含哪些？

训练数据主要包含优质开源代码、技术社区文章和技术文档、阿里云的云服务文档、阿里云 SDK/API 使用文档等。

3. 我的代码片段会与其他用户共享吗？

不会。使用大模型进行代码补全时，我们需要获取您的代码上下文信息以完成补全，但上下文信息不会被存储或用于其他任何目的，该等数据完全由您所有及控制。

4. 通义灵码生成的代码可以直接使用吗？

通义灵码生成的代码只是建议代码，无法确保其可用性，需要开发人员自行对代码进行审核和决定是否采纳。

1. 如果发现 Lingma 进程占用 CPU 或内存过高怎么办？

• 情况1：可能因为您的代码工程文件较多，导致代码索引时消耗 CPU 或内存过高，可以在工程根目录创建 .tongyiignore 文件，将不需要索引的目录或文件排除，从而减少索引时的 CPU 或内存占用，.tongyiignore 内容格式与 .gitignore 相同，修改 .tongyiignore 内容后，手动结束 Lingma 进程后配置即可生效。

• 情况2：可能是因为开启了本地离线模型，本模型会占用 500M 左右内存，如您无需使用离线模型，可在设置中关闭离线模型补全功能。

2. VS Code插件中的个人中心页面报错怎么办？

如果您看到以下报错信息，"Error loading webview: Error: Could not register service worker: InvalidStateError: Failed to register a ServiceWorker: The document is in an invalid state."

这是一个 VS Code 1.56 中的已知问题，当某些 Windows 用户以管理员身份运行 VS Code 时，就会发生这种情况。您可以尝试以下方式进行解决。

• 方式1： --no-sandbox 命令行标志启动 VS Code：

  $ code --no-sandbox

• 方式2：关闭 VS Code，然后在终端中尝试运行：killall code

3. 在 JetBrains IDEs 中安装通义灵码插件完成后，侧边栏不显示Lingma按钮怎么办？

一般来说安装完成后，Lingma助手按钮都会显示到 IDE 侧边栏。如遇到不显示的情况，您可选择view > Tool Windows > Lingma（视图 > 工具窗口 > 通义灵码）手动打开。

1. 每页查询的数据量是否有上限？

建议不超过10000条。但是在进行数据查询与展示时，设定每页查询的数据量上限对于确保系统性能和优化用户体验至关重要，具体数值应根据实际应用场景及系统能力灵活调整。

2. API的数据在每天凌晨更新，更新频率是什么？

API 数据从每日凌晨开始每15分钟更新一次，通过多重校验机制确保数据的实时性、可靠性和灵活性。所以在凌晨两点是可以获取到昨天最新且准确的完整数据集。

3. API使用频率有没有要求？

为确保服务稳定高效，我们的 API 调用频率上限为 100 QPS，即每秒最多 100 次请求。

4. organizationId 获取方式

在通义灵码控制台右上角的头像，单击管理后台，然后在基本信息页面复制组织ID 。