通义听悟可以自动给 .py、.js、.ja va、.cpp 这类 UTF-8 纯文本代码添加中文注释。支持网页端上传，也可以用 raw 链接导入。生成之后，记得人工校对一反赌释位置和语言风格，然后导出 Word 手动合并到源码里——省去逐行手写解释的重复劳动，尤其适合接手别人写的项目，或者快速理解一堆老旧脚本。

准备待注释的代码文件

先确保代码文件是纯文本格式（.py、.js、.ja va、.cpp 等），别混进编译产物、二进制内容或者损坏的字符。通义听悟不支持直接解析 .exe、.dll 或者已经混淆过的 min.js 文件，这点要注意。

文件编码一定要保存为 UTF-8。如果习惯用记事本，另存时记得在“编码”下拉菜单里选【UTF-8】，否则生成的中文注释可能变成乱码，或者干脆失败。这一步其实很简单，把文件拖进去就行，但编码问题容易被忽略，所以特地提一下。

上传并触发AI注释生成

两种方式，任选其一。

方法一：网页端直接上传
打开 https://tingwu.aliyun.com → 登录阿里账号 → 首页点击「上传文件」→ 选中你的代码文件 → 等上传完成 → 右侧功能栏点「AI辅助」→ 选「添加注释」→ 点「开始生成」。整个过程几分钟搞定。

方法二：用“播客链接转写”入口变通
如果代码已经托管在 GitHub 或 GitLab 上，可以直接复制那个文件的 raw 链接（比如 https://raw.githubusercontent.com/xxx/main.py）。回到通义听悟首页 → 点「播客链接转写」→ 粘贴 raw 链接 → 系统自动抓取文本内容 → 进入编辑页后点「AI辅助 → 添加注释」。

【注意：必须是 raw 链接，不能是网页版浏览页链接，否则会抓取 HTML 源码而非纯代码】

校对与导出注释结果

AI 生成注释后，别急着关闭，有三件事要检查。

第一步：看注释位置对不对
通义听悟会在函数定义、循环块、条件分支前面插入中文说明，不会改动原代码缩进和结构。但偶尔会出现注释错位——比如跑到某行代码中间去了，说明模型没识别对语法边界，这时候需要手动挪动一下。

第二步：确认语言风格符合团队规范
默认输出偏技术文档口吻，比如“此处校验用户输入合法性”。如果团队习惯用指令式，比如“检查用户名是否为空”，或者喜欢问题导向，比如“为什么这里要重试三次？”，直接在编辑框里改就行，AI 不会锁定文本。

第三步：导出带注释的完整文件
点右上角「导出」→ 选「Word（.docx）」格式 → 下载后用 Word 打开，复制注释段落，粘贴回原代码编辑器对应位置即可。注意，通义听悟不支持直接导出修改后的源码文件，必须手动合并这一步。