需10分钟内理解陈旧代码：先确认copilot就绪，选中函数用/explain解析；从入口函数逐级解释调用链，跳过第三方库，聚焦legacy/fallback分支；遇解释失效时补运行时假设、分段解析或切换utf-8编码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
面对一个没有文档、变量命名混乱、逻辑嵌套三层以上的陈旧代码文件，你急需在10分钟内搞清它到底在做什么、关键分支在哪里、哪些函数真正影响输出结果。
先确认当前环境是否支持/explain
打开 VS Code 或 JetBrains IDE，确保右下角 Copilot 状态图标为蓝色且显示“Ready”。若为灰色或提示“Sign in”，需先完成 GitHub 账号授权并启用 Copilot Chat 功能。
在任意代码文件中，选中一段函数体（哪怕只有3行），按 Ctrl+I（Windows/Linux）或 Cmd+I（macOS）唤出聊天输入框——如果输入框弹出且光标可编辑，说明 /explain 已就绪。
用/explain吃透单个函数
方法一：直接触发解释指令
选中目标函数的全部代码（包括函数声明行），在聊天输入框中输入 /explain 并回车。Copilot 会立即返回一段结构化说明，包含功能目的、参数含义、返回值逻辑和关键副作用。
方法二：用自然语言引导更精准输出
同样选中函数，输入：Explain this function step-by-step, highlight where it reads from disk and where it modifies global state。这种带约束的提问比单纯 /explain 更容易避开泛泛而谈的废话，尤其适合排查陈旧代码中的隐式依赖。
【必须选中代码再输入指令，否则 Copilot 会默认解释整个文件，响应变慢且重点模糊】
穿透多层调用链理解主流程
第一步：定位入口函数
在项目根目录搜索关键词 main、init、start、run 或查看 package.json 中的 scripts 字段，找到程序实际启动点。
第二步：从入口开始逐级解释
选中入口函数 → 输入 /explain → 阅读返回内容，特别注意其中提到的“calls”“invokes”“delegates to”等动词指向的其他函数名；把这些函数名复制出来，在对应文件中打开、选中、再次 /explain。
第三步：跳过已知稳定模块
若某函数名含 lodash、moment、axios 等明确第三方库前缀，或属于 node_modules 下路径，可跳过解释——它们行为确定，问题通常出在业务胶水层。
第四步：对准可疑分支补全上下文
当 /explain 返回中出现“handles legacy format”“fallback for v1 API”等描述时，立刻选中该 if/else 块或 try/catch 内部代码，单独执行一次 /explain。陈旧代码的坑，90% 都藏在这些被标记为“legacy”“fallback”“deprecated”的分支里。
识别并绕过解释失效的典型场景
当 Copilot 返回“Unable to analyze”“This code is too complex”或大段重复描述时，大概率遇到以下三种情况之一：
① 代码中存在未定义的全局变量（如 window、process、__DEV__），Copilot 缺乏运行时上下文；此时手动在解释指令前加一句：Assume this runs in Node.js v14 with process.env.NODE_ENV = 'production'。
② 函数内联了大量字符串拼接或动态 require，导致 AST 解析断裂；这时不要整函数选中，改为分段：先选中第一段赋值语句 → /explain，再选中后续关键判断 → /explain，最后把两段结论手动串联。
③ 文件编码非 UTF-8（如 GBK、ISO-8859-1），Copilot 解析乱码；此时必须先用 VS Code 右下角编码切换器改为 UTF-8 并保存，否则所有 /explain 均无效。
