必须先完成插件安装、ide版本达标（2023.2+）、开启自动补全总开关并关闭行间/整行干扰提示，否则通义灵码无法触发代码补全；低版本pycharm不支持补全事件监听，未重启ide则蓝色“l”图标不出现，登录与补全功能均失效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在PyCharm中让通义灵码真正开始帮你补全代码，必须先确保插件已安装、IDE版本达标、自动补全总开关打开，且行间/整行干扰提示已关闭——低版本PyCharm（2023.2以下）即使装了最新插件也无法监听补全事件，所有设置都将无效；未重启IDE则蓝色“L”图标不会出现，登录和补全功能完全不可用。
确认插件启用与IDE版本兼容性
进入 File → Settings（Windows/Linux）或 PyCharm → Preferences（macOS）→ 左侧点击 Plugins → 在右上角搜索框输入 Tongyi Lingma；
检查右侧是否显示 Enabled 且版本号 ≥ 4.12.0；若显示 Download，说明当前装的是旧版插件——【官方明确要求 PyCharm 2023.2+ / IDEA 2023.2+ 才支持自动补全事件监听】；
通过 Help → About → Build number 验证实际IDE版本，避免因环境不达标导致后续所有设置失效。
开启自动补全总开关
方法一：直达设置路径
进入 Settings → Tongyi Lingma → Code Completion，勾选 Enable auto code completion；
PyCharm 2026.2提供 JetBrains 官方 2026.2 版本安装包，适合需要指定 PyCharm 版本进行 Python 项目开发、运行和调试的用户。
方法二：快捷入口
点击右下角状态栏通义灵码图标 → 弹出菜单中确认 Auto Completion 已点亮为蓝色；【该选项默认关闭，装完插件不会自动生效，必须手动开启】；
关闭状态下，无论输入什么都不会触发AI补全，且无任何提示。
精细管控补全行为
第一步：关闭行间与整行建议
进入 Settings → Extensions → Tongyi Lingma → 展开「Code Completion」设置组 → 关闭 Enable Inline Suggestions 和 Enable Full Line Suggestions；
第二步：保留手动触发能力
保持 Enable Auto Completion 开启，但禁用上述两项后，灰色行间文字和虚线整行提示全部消失，仅保留 Alt+P（Windows）/⌥P（macOS）手动唤起补全的能力；
第三步：验证补全响应
在Python文件中输入 def calc_ → 按 Alt+P → 观察是否弹出函数签名建议；若无响应，返回检查IDE版本与插件状态；若弹出但内容为空白或报错，请确认已登录阿里云账号且网络可访问 lingma.aliyun.com。
