通义灵码 · 装在编辑器里的中文 AI 编程助手

通义灵码是阿里出品的一款 AI 编程助手，它不是一个单独的软件，而是"装进"你写代码的工具里的插件（插件可以理解为给软件加功能的小配件）。装上之后，你写代码时它会自动帮你补，看不懂的代码它能解释，还能用中文告诉它需求让它直接写出来。国内网络就能用，中文理解好，适合国内的开发者，也适合想试着做点小东西的新手。

一、它能帮你做什么

• 写代码时自动补全：你刚敲出开头几个字，它就把后面可能要写的一整行甚至一整段"猜"出来，你按一下 Tab 键就能采纳，像输入法的联想但更聪明。
• 用中文描述需求直接生成代码：在代码文件里用中文写一句注释（注释就是写给程序员看的说明文字，不会被程序执行），比如"写一个函数，读取表格文件并画出折线图"，它就能把代码补出来。
• 解释看不懂的代码：选中一段别人写的代码，点"解释代码"，它会用中文逐段说明这段代码在干什么、数据是怎么流转的。
• 看懂并修好报错：程序跑不起来时，把红色的错误提示复制到对话框里，让它"帮我看看这个报错是什么意思、怎么改"。
• 给代码加注释和写测试：选中一段代码让它"加上中文注释"，或"给这个函数写几个测试用例"（测试用例就是用来验证代码对不对的小检查）。
• 优化和改造已有代码：选中代码后说"让它更容易读""改得运行快一点""把重复的部分合并"，它会给出改法。

二、怎么打开 / 安装

如果搜索不到插件，先确认你的编辑器版本不是太旧，或者到通义灵码官方网站查看当前支持哪些编辑器。安装过程中出现权限提示，点允许即可。 👉 点此直达 通义灵码 官网 / 应用商店打开 →

三、第一次怎么用（照着做就行）

1. 先在电脑上安装好 VS Code（一个免费的代码编辑器，去官网下载安装即可），然后按上面的方法装好通义灵码插件并登录。
2. 新建一个文件夹当作你的练习项目，在 VS Code 里点"文件 → 打开文件夹"，选这个文件夹打开。
3. 在文件夹里新建一个文件，起名叫 test.py（.py 表示这是一个 Python 程序文件，Python 是一门常见的编程语言）。不会装运行环境也没关系，先跟着做完这一步。
4. 在文件里用中文写一行注释：# 写一个函数，输入一串数字，返回它们的平均值，然后按回车换行。稍等一下，它会自动浮出灰色的补全建议。
5. 看一眼建议的内容，觉得对就按 Tab 键采纳；不对就继续自己打字，或者直接按 Esc 关掉提示。这是最常用的"自动补全"用法。
6. 选中刚生成的代码（鼠标拖着选），点右键，找"通义灵码"相关的菜单，选"解释代码"。右侧就会用中文说明这段代码每一行的作用——不会代码也能看懂它在干什么。
7. 接着在左侧灵码图标打开的对话框里提需求，例如："帮我写一个把摄氏度转成华氏度的小程序，运行后让用户输入数字，并打印结果。"它会给出完整代码，你复制到文件里保存。
8. 想继续改，就在对话框里接着说："再加一个功能，输入错误时提示用户重新输入。"它会基于刚才的代码继续改。随时可以问"这段代码怎么运行"，让它告诉你具体的操作步骤。

四、可以直接复制的提示词

下面模板里用【】标出的部分，替换成你自己的内容。通义灵码对中文支持很好，直接用中文提需求即可。

请帮我用【Python】写一个小程序，功能是：【输入一串用逗号分隔的数字，
输出它们的平均值、最大值和最小值】。
要求：
1. 代码要有中文注释；
2. 输入不合法时给出友好提示，不要直接报错崩溃；
3. 写完后用两三句话告诉我怎么运行它。

请用完全不懂编程的人能听懂的话，解释下面这段代码在做什么：【粘贴代码】。
解释时按"先说整体目的，再逐段说明"的顺序，
遇到专业名词请用一句话解释。

我运行的时候出现了下面这个报错：【把错误提示整段粘贴到这里】。
请帮我：
1. 说明这个报错是什么意思；
2. 指出最可能出错的地方；
3. 给出修改后的完整代码，并标注你改了哪里。

请给下面这段代码加上中文注释，并做两件事：【粘贴代码】
1. 指出其中可能有隐患的地方（比如容易出错、效率较低）；
2. 在不改变功能的前提下，给出一版更易读的写法。

五、好用的小技巧

• 把需求写在注释里：这是最省事的用法。先写中文注释说清要干什么，换行等它补全，比打开对话框更顺手。
• 选中再问，效果更好：不要空着问"帮我优化代码"。先选中具体的代码再提问，它才知道你要改的是哪一段。
• 让它先讲再改：拿到陌生代码先让它"解释"，确认它理解对了，再说"按刚才的理解帮我改成……"，出错概率低很多。
• 一次只改一件事：让它加功能就只加功能，让它改格式就只改格式。混在一起容易把原本能跑的代码改坏。
• 追问运行方法：不会运行就直说"我装了 Python，请告诉我这个文件要怎么运行，一步一步说"，它会连命令一起告诉你。
• 改完先小范围验证：先用一两条简单数据试一下，确认结果对了再拿去处理正式数据。

六、注意事项

• 不要暴露敏感信息：不要在代码里写密码、密钥、数据库连接串、身份证号等，也不要把含这类信息的文件整段交给它分析。
• 生成的代码必须自己检查：AI 写的代码可能跑不通、可能有隐藏问题。先在测试数据上跑一遍，确认无误再用到正式项目里。
• 留意使用额度：免费版有使用额度限制，重度使用或团队协作可能涉及其他版本，具体以官方页面为准。
• 重要文件先备份：它会直接修改你打开的文件，改动大项目前先复制一份，或确认改动内容再应用，避免覆盖原稿。
• 合规使用：不要用它生成病毒、批量爬虫、刷量作弊等违法或违反平台规则的代码；在公司项目中使用前，先确认单位对 AI 编程工具的规定。