GitHub Copilot Chat进阶指令：/explain快速吃透陈旧代码
想想看，接手一段没有文档、变量名瞎取、逻辑嵌套三层起步的陈旧代码——你还得在10分钟内摸清它的底细：到底在做什么、关键分支在哪、哪些函数真正决定输出结果。第一反应是不是有点头皮发麻？别急，下面这套方法能让 Copilot 当你的速读搭档。
先确认当前环境是否支持/explain
打开 VS Code 或 JetBrains IDE，先看一眼右下角的 Copilot 状态图标——它必须亮着蓝色，并且显示“Ready”。如果是灰色或者提示“Sign in”，得先搞定 GitHub 账号授权，把 Copilot Chat 功能启用起来。
随便挑一个代码文件，选中哪怕只有三行的函数体，按下 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。陈旧代码的坑，九成都藏在这些被标记为“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 都会失效。