必须确保ide版本≥2021.3且jdk≥11，网络可访问aigc.aliyun.com等域名，并预留≥2.5gb磁盘空间，否则插件无法启动或补全失效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
通义灵码安装前必须确保开发环境满足最低运行要求，否则安装后无法启动或代码补全功能完全失效。需要提前检查系统版本、IDE兼容性、网络连通性以及Java运行时环境是否就绪。
确认IDE版本是否支持
通义灵码仅支持 IntelliJ IDEA 2021.3 及以上版本（含 JetBrains 全系 IDE：PyCharm、WebStorm、GoLand 等），低于该版本的 IDE 将无法加载插件。
打开 IDE → Help → About → 查看 Build Number，如显示 213.xxx 或更高即符合要求；若为 212.x 或更低，请先升级 IDE 官方最新稳定版。
这一步不能跳过，【旧版 IDE 安装插件后会直接报错“Plugin incompatible”且无任何提示】。
检查 Java 运行时环境（JRE）
IntelliJ 系列 IDE 自带 JBR（JetBrains Runtime），但部分企业定制版或手动替换过 JDK 的环境可能使用外部 JDK。
进入 Help → Find Action → 输入 “Switch Boot JDK” → 确认当前 Boot JDK 版本 ≥ 11（推荐 17 或 21）。
若显示 JDK 8 或未识别到有效 JDK，需重新配置：点击 “+ Add JDK” → 选择本地已安装的 JDK 11+ 路径（如 /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home）。
通义灵码 Linux版是阿里云推出的一款AI智能编码助手，专为Linux开发者设计。它支持在Linux操作系统下的JetBrains IDEs、Visual Studio Code等主流集成开发环境中运行。该工具基于通义大模型，提供代码智能生成、实时续写、单元测试生成、代码优化以及研发智能问答等功能，旨在帮助Linux用户在编码过程中提升效率。
验证网络访问权限
通义灵码首次启用需连接阿里云服务端完成账号绑定与模型初始化，必须能直连以下域名：
• aigc.aliyun.com
• aliyun-openapi.oss-cn-shanghai.aliyuncs.com
• sts.cn-shanghai.aliyuncs.com
公司内网或教育网用户请提前联系 IT 部门开通上述域名的 HTTPS（443）出口白名单；使用代理的用户需在 IDE 设置中开启 “Use system proxy settings” 或手动填写 HTTP Proxy。
【禁用全局科学上网工具，否则会导致登录页面空白或 token 获取失败】。
预留本地磁盘空间
方法一：查看默认缓存目录容量
IDE 默认将模型文件下载至系统缓存路径（如 Windows：C:\Users\{user}\AppData\Local\JetBrains\IntelliJIdea2023.3\cache\aliyun-aigc；macOS：~/Library/Caches/JetBrains/IdeaIC2023.3/aliyun-aigc）。需确保该磁盘剩余空间 ≥ 2.5 GB。
方法二：自定义缓存位置（推荐）
Help → Find Action → 输入 “Registry” → 找到 ide.plugin.alicloud.cache.path → 双击编辑 → 填写一个剩余空间充足的路径（如 D:\aliyun-cache）→ 重启 IDE 生效。
