[{"data":1,"prerenderedAt":4203},["ShallowReactive",2],{"article-/topics/ai/ai-agent-output-merge-conflict-resolution":3,"related-ai":806,"content-query-IBIabZbaZc":3572},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"date":10,"topic":5,"author":11,"tags":12,"image":17,"imageQuery":18,"pexelsPhotoId":19,"pexelsUrl":20,"featured":6,"readingTime":21,"body":22,"_type":800,"_id":801,"_source":802,"_file":803,"_stem":804,"_extension":805},"/topics/ai/ai-agent-output-merge-conflict-resolution","ai",false,"","AI agent 输出合并与冲突解决：多个工具或 agent 同时修改草稿/状态时怎么收口","AI agent 一旦有多路输出，真正难的不是生成，而是收口。本文讲清 merge proposal、冲突分级、状态冲突策略与 human merge gate，避免最后一步最混乱。","2026-05-10","HTMLPAGE 团队",[13,14,15,16],"AI agent","merge","conflict resolution","工程实践","/images/articles/ai-agent-output-merge-conflict-resolution-featured.jpg","team document editing review laptop",7734568,"https://www.pexels.com/photo/a-person-holding-pen-and-paper-7734568/",20,{"type":23,"children":24,"toc":786},"root",[25,33,38,75,82,149,154,160,165,241,246,252,257,269,274,279,378,383,389,394,414,419,425,430,449,454,460,465,488,493,498,507,512,518,523,623,628,634,639,644,650,740,745,750,755],{"type":26,"tag":27,"props":28,"children":29},"element","p",{},[30],{"type":31,"value":32},"text","AI agent 一旦开始多步执行、并发调用工具、接收人工修改或者多 agent 协作，系统就迟早会遇到一个问题：最后到底应该以哪份结果为准。冲突可能来自多个 draft 同时修改同一段内容，也可能来自不同工具对同一个状态给出相反结果。",{"type":26,"tag":27,"props":34,"children":35},{},[36],{"type":31,"value":37},"如果没有 merge 与 conflict 设计，系统最常见的表现不是报错，而是默默用最后一次写入覆盖前面的结果，直到后续有人发现“为什么这段刚改过又变回去了”。",{"type":26,"tag":27,"props":39,"children":40},{},[41,43,50,52,58,59,65,67,73],{"type":31,"value":42},"建议先结合 ",{"type":26,"tag":44,"props":45,"children":47},"a",{"href":46},"/topics/ai/ai-agent-artifact-design-intermediate-output",[48],{"type":31,"value":49},"AI agent Artifact 设计",{"type":31,"value":51},"、",{"type":26,"tag":44,"props":53,"children":55},{"href":54},"/topics/ai/ai-agent-workspace-state-layout-guide",[56],{"type":31,"value":57},"AI agent Workspace 状态分层",{"type":31,"value":51},{"type":26,"tag":44,"props":60,"children":62},{"href":61},"/topics/ai/ai-agent-run-ledger-audit-model",[63],{"type":31,"value":64},"AI agent Run Ledger 审计模型",{"type":31,"value":66}," 和 ",{"type":26,"tag":44,"props":68,"children":70},{"href":69},"/topics/ai/ai-agent-human-review-console-design",[71],{"type":31,"value":72},"AI agent 人工审批控制台设计",{"type":31,"value":74}," 一起看。",{"type":26,"tag":76,"props":77,"children":79},"h2",{"id":78},"先给结论不要直接-merge-最终结果先-merge-proposal",[80],{"type":31,"value":81},"先给结论：不要直接 merge 最终结果，先 merge proposal",{"type":26,"tag":83,"props":84,"children":85},"table",{},[86,105],{"type":26,"tag":87,"props":88,"children":89},"thead",{},[90],{"type":26,"tag":91,"props":92,"children":93},"tr",{},[94,100],{"type":26,"tag":95,"props":96,"children":97},"th",{},[98],{"type":31,"value":99},"合并对象",{"type":26,"tag":95,"props":101,"children":102},{},[103],{"type":31,"value":104},"风险",{"type":26,"tag":106,"props":107,"children":108},"tbody",{},[109,123,136],{"type":26,"tag":91,"props":110,"children":111},{},[112,118],{"type":26,"tag":113,"props":114,"children":115},"td",{},[116],{"type":31,"value":117},"直接改最终状态",{"type":26,"tag":113,"props":119,"children":120},{},[121],{"type":31,"value":122},"最容易覆盖正确结果",{"type":26,"tag":91,"props":124,"children":125},{},[126,131],{"type":26,"tag":113,"props":127,"children":128},{},[129],{"type":31,"value":130},"直接改当前 draft",{"type":26,"tag":113,"props":132,"children":133},{},[134],{"type":31,"value":135},"人工和 agent 修改会互相踩踏",{"type":26,"tag":91,"props":137,"children":138},{},[139,144],{"type":26,"tag":113,"props":140,"children":141},{},[142],{"type":31,"value":143},"先产出 merge proposal",{"type":26,"tag":113,"props":145,"children":146},{},[147],{"type":31,"value":148},"可以先判断冲突再决定如何落地",{"type":26,"tag":27,"props":150,"children":151},{},[152],{"type":31,"value":153},"真正稳的系统，通常先让不同来源产出 proposal，再由 merge gate 决定哪部分可以自动合并，哪部分必须人工确认。",{"type":26,"tag":76,"props":155,"children":157},{"id":156},"一先把冲突分层不要所有冲突都当成文本-diff",[158],{"type":31,"value":159},"一、先把冲突分层，不要所有冲突都当成文本 diff",{"type":26,"tag":27,"props":161,"children":162},{},[163],{"type":31,"value":164},"更常见的冲突其实至少有三类：",{"type":26,"tag":83,"props":166,"children":167},{},[168,184],{"type":26,"tag":87,"props":169,"children":170},{},[171],{"type":26,"tag":91,"props":172,"children":173},{},[174,179],{"type":26,"tag":95,"props":175,"children":176},{},[177],{"type":31,"value":178},"冲突类型",{"type":26,"tag":95,"props":180,"children":181},{},[182],{"type":31,"value":183},"例子",{"type":26,"tag":106,"props":185,"children":186},{},[187,200,228],{"type":26,"tag":91,"props":188,"children":189},{},[190,195],{"type":26,"tag":113,"props":191,"children":192},{},[193],{"type":31,"value":194},"文本冲突",{"type":26,"tag":113,"props":196,"children":197},{},[198],{"type":31,"value":199},"两份 draft 改了同一段文案",{"type":26,"tag":91,"props":201,"children":202},{},[203,208],{"type":26,"tag":113,"props":204,"children":205},{},[206],{"type":31,"value":207},"字段冲突",{"type":26,"tag":113,"props":209,"children":210},{},[211,213,220,222],{"type":31,"value":212},"一个工具说 ",{"type":26,"tag":214,"props":215,"children":217},"code",{"className":216},[],[218],{"type":31,"value":219},"status=approved",{"type":31,"value":221},"，另一个说 ",{"type":26,"tag":214,"props":223,"children":225},{"className":224},[],[226],{"type":31,"value":227},"status=rejected",{"type":26,"tag":91,"props":229,"children":230},{},[231,236],{"type":26,"tag":113,"props":232,"children":233},{},[234],{"type":31,"value":235},"顺序冲突",{"type":26,"tag":113,"props":237,"children":238},{},[239],{"type":31,"value":240},"某一步结果基于旧版本 artifact 继续生成",{"type":26,"tag":27,"props":242,"children":243},{},[244],{"type":31,"value":245},"如果系统只会做文本 diff，它根本无法覆盖最危险的状态冲突。",{"type":26,"tag":76,"props":247,"children":249},{"id":248},"二merge-proposal-最好带来源和意图不只带-diff",[250],{"type":31,"value":251},"二、Merge proposal 最好带来源和意图，不只带 diff",{"type":26,"tag":27,"props":253,"children":254},{},[255],{"type":31,"value":256},"一个更有用的 proposal 结构通常会长这样：",{"type":26,"tag":258,"props":259,"children":264},"pre",{"className":260,"code":262,"language":263,"meta":7},[261],"language-json","{\n \"proposalId\": \"merge_001\",\n \"targetArtifact\": \"draft_004\",\n \"source\": \"review_agent\",\n \"changeType\": \"field_update\",\n \"intendedImpact\": \"replace call_to_action\",\n \"baseVersion\": 4\n}\n","json",[265],{"type":26,"tag":214,"props":266,"children":267},{"__ignoreMap":7},[268],{"type":31,"value":262},{"type":26,"tag":27,"props":270,"children":271},{},[272],{"type":31,"value":273},"这样系统不只是看到“改了什么”，还能看到“谁提议改、准备影响什么”。",{"type":26,"tag":27,"props":275,"children":276},{},[277],{"type":31,"value":278},"但 proposal 有了还不够，系统最好再把冲突严重级别单独分层：",{"type":26,"tag":83,"props":280,"children":281},{},[282,303],{"type":26,"tag":87,"props":283,"children":284},{},[285],{"type":26,"tag":91,"props":286,"children":287},{},[288,293,298],{"type":26,"tag":95,"props":289,"children":290},{},[291],{"type":31,"value":292},"severity",{"type":26,"tag":95,"props":294,"children":295},{},[296],{"type":31,"value":297},"典型场景",{"type":26,"tag":95,"props":299,"children":300},{},[301],{"type":31,"value":302},"默认动作",{"type":26,"tag":106,"props":304,"children":305},{},[306,324,342,360],{"type":26,"tag":91,"props":307,"children":308},{},[309,314,319],{"type":26,"tag":113,"props":310,"children":311},{},[312],{"type":31,"value":313},"low",{"type":26,"tag":113,"props":315,"children":316},{},[317],{"type":31,"value":318},"纯文本局部改动",{"type":26,"tag":113,"props":320,"children":321},{},[322],{"type":31,"value":323},"自动 merge",{"type":26,"tag":91,"props":325,"children":326},{},[327,332,337],{"type":26,"tag":113,"props":328,"children":329},{},[330],{"type":31,"value":331},"medium",{"type":26,"tag":113,"props":333,"children":334},{},[335],{"type":31,"value":336},"字段值不同但无副作用",{"type":26,"tag":113,"props":338,"children":339},{},[340],{"type":31,"value":341},"先校验再 merge",{"type":26,"tag":91,"props":343,"children":344},{},[345,350,355],{"type":26,"tag":113,"props":346,"children":347},{},[348],{"type":31,"value":349},"high",{"type":26,"tag":113,"props":351,"children":352},{},[353],{"type":31,"value":354},"审批、权限、外发状态冲突",{"type":26,"tag":113,"props":356,"children":357},{},[358],{"type":31,"value":359},"强制进入 human gate",{"type":26,"tag":91,"props":361,"children":362},{},[363,368,373],{"type":26,"tag":113,"props":364,"children":365},{},[366],{"type":31,"value":367},"critical",{"type":26,"tag":113,"props":369,"children":370},{},[371],{"type":31,"value":372},"已有副作用且结果互斥",{"type":26,"tag":113,"props":374,"children":375},{},[376],{"type":31,"value":377},"阻断并先对账",{"type":26,"tag":27,"props":379,"children":380},{},[381],{"type":31,"value":382},"这样 merge gate 看到的就不只是“有冲突”，而是系统已经先判断了这类冲突该不该自动推进。",{"type":26,"tag":76,"props":384,"children":386},{"id":385},"三自动合并适合低风险字段不适合高风险状态",[387],{"type":31,"value":388},"三、自动合并适合低风险字段，不适合高风险状态",{"type":26,"tag":27,"props":390,"children":391},{},[392],{"type":31,"value":393},"一个简单但有效的原则是：",{"type":26,"tag":395,"props":396,"children":397},"ul",{},[398,404,409],{"type":26,"tag":399,"props":400,"children":401},"li",{},[402],{"type":31,"value":403},"文本说明、低风险元数据：可自动 merge",{"type":26,"tag":399,"props":405,"children":406},{},[407],{"type":31,"value":408},"权限、审批、外发、资金相关状态：默认不自动 merge",{"type":26,"tag":399,"props":410,"children":411},{},[412],{"type":31,"value":413},"冲突字段涉及副作用：必须进入 human merge gate",{"type":26,"tag":27,"props":415,"children":416},{},[417],{"type":31,"value":418},"系统不是越自动越好，而是越知道哪些东西不该自动越好。",{"type":26,"tag":76,"props":420,"children":422},{"id":421},"四状态冲突要优先于文本冲突处理",[423],{"type":31,"value":424},"四、状态冲突要优先于文本冲突处理",{"type":26,"tag":27,"props":426,"children":427},{},[428],{"type":31,"value":429},"很多实现会先把文字合并好，最后才发现底层状态已经互相矛盾。更健康的顺序通常是：",{"type":26,"tag":431,"props":432,"children":433},"ol",{},[434,439,444],{"type":26,"tag":399,"props":435,"children":436},{},[437],{"type":31,"value":438},"先检查状态冲突",{"type":26,"tag":399,"props":440,"children":441},{},[442],{"type":31,"value":443},"再检查字段冲突",{"type":26,"tag":399,"props":445,"children":446},{},[447],{"type":31,"value":448},"最后才处理文本冲突",{"type":26,"tag":27,"props":450,"children":451},{},[452],{"type":31,"value":453},"原因很简单：状态冲突一旦没被挡住，后面的文本再漂亮也可能建立在错误前提上。",{"type":26,"tag":76,"props":455,"children":457},{"id":456},"五人工-merge-gate-最少要展示-4-类信息",[458],{"type":31,"value":459},"五、人工 merge gate 最少要展示 4 类信息",{"type":26,"tag":27,"props":461,"children":462},{},[463],{"type":31,"value":464},"当系统决定不能自动合并时，审批台最好直接展示：",{"type":26,"tag":395,"props":466,"children":467},{},[468,473,478,483],{"type":26,"tag":399,"props":469,"children":470},{},[471],{"type":31,"value":472},"base version 和当前 version",{"type":26,"tag":399,"props":474,"children":475},{},[476],{"type":31,"value":477},"各 proposal 的来源与意图",{"type":26,"tag":399,"props":479,"children":480},{},[481],{"type":31,"value":482},"哪些字段可自动合并，哪些字段冲突",{"type":26,"tag":399,"props":484,"children":485},{},[486],{"type":31,"value":487},"合并后会触发什么副作用",{"type":26,"tag":27,"props":489,"children":490},{},[491],{"type":31,"value":492},"这会比给审核者一个纯文本 diff 稳定得多，因为很多冲突本来就不是纯文本问题。",{"type":26,"tag":27,"props":494,"children":495},{},[496],{"type":31,"value":497},"进一步说，审批台最好还能输出一份 merge decision record，而不是只保留最终稿：",{"type":26,"tag":258,"props":499,"children":502},{"className":500,"code":501,"language":263,"meta":7},[261],"{\n \"targetArtifact\": \"draft_004\",\n \"acceptedProposalIds\": [\"merge_001\"],\n \"rejectedProposalIds\": [\"merge_007\"],\n \"conflictSeverity\": \"high\",\n \"sideEffectGate\": \"blocked_until_review\"\n}\n",[503],{"type":26,"tag":214,"props":504,"children":505},{"__ignoreMap":7},[506],{"type":31,"value":501},{"type":26,"tag":27,"props":508,"children":509},{},[510],{"type":31,"value":511},"这份记录的价值在于，后续一旦有人问“为什么选了这一版而不是那一版”，系统能回到具体决策，而不是只看到最终文本。",{"type":26,"tag":76,"props":513,"children":515},{"id":514},"六上线后要看-merge-质量而不是只看冲突次数",[516],{"type":31,"value":517},"六、上线后要看 merge 质量，而不是只看冲突次数",{"type":26,"tag":27,"props":519,"children":520},{},[521],{"type":31,"value":522},"建议至少记录：",{"type":26,"tag":83,"props":524,"children":525},{},[526,542],{"type":26,"tag":87,"props":527,"children":528},{},[529],{"type":26,"tag":91,"props":530,"children":531},{},[532,537],{"type":26,"tag":95,"props":533,"children":534},{},[535],{"type":31,"value":536},"指标",{"type":26,"tag":95,"props":538,"children":539},{},[540],{"type":31,"value":541},"用途",{"type":26,"tag":106,"props":543,"children":544},{},[545,558,571,584,597,610],{"type":26,"tag":91,"props":546,"children":547},{},[548,553],{"type":26,"tag":113,"props":549,"children":550},{},[551],{"type":31,"value":552},"auto-merge success ratio",{"type":26,"tag":113,"props":554,"children":555},{},[556],{"type":31,"value":557},"看自动合并边界是否合理",{"type":26,"tag":91,"props":559,"children":560},{},[561,566],{"type":26,"tag":113,"props":562,"children":563},{},[564],{"type":31,"value":565},"human merge required ratio",{"type":26,"tag":113,"props":567,"children":568},{},[569],{"type":31,"value":570},"看冲突是否过多依赖人工",{"type":26,"tag":91,"props":572,"children":573},{},[574,579],{"type":26,"tag":113,"props":575,"children":576},{},[577],{"type":31,"value":578},"human merge turnaround time",{"type":26,"tag":113,"props":580,"children":581},{},[582],{"type":31,"value":583},"看人工 gate 是否成为瓶颈",{"type":26,"tag":91,"props":585,"children":586},{},[587,592],{"type":26,"tag":113,"props":588,"children":589},{},[590],{"type":31,"value":591},"post-merge rollback rate",{"type":26,"tag":113,"props":593,"children":594},{},[595],{"type":31,"value":596},"看合并质量是否稳定",{"type":26,"tag":91,"props":598,"children":599},{},[600,605],{"type":26,"tag":113,"props":601,"children":602},{},[603],{"type":31,"value":604},"side-effect conflict blocked count",{"type":26,"tag":113,"props":606,"children":607},{},[608],{"type":31,"value":609},"看关键冲突是否被成功拦下",{"type":26,"tag":91,"props":611,"children":612},{},[613,618],{"type":26,"tag":113,"props":614,"children":615},{},[616],{"type":31,"value":617},"stale base version conflict rate",{"type":26,"tag":113,"props":619,"children":620},{},[621],{"type":31,"value":622},"看 proposal 是否常基于旧版本生成",{"type":26,"tag":27,"props":624,"children":625},{},[626],{"type":31,"value":627},"如果 auto-merge 很高，但 post-merge rollback 也高，说明系统在“快合并”，不是在“稳合并”。",{"type":26,"tag":76,"props":629,"children":631},{"id":630},"七失败案例人工已经改过-ctaagent-后续生成又把它覆盖掉",[632],{"type":31,"value":633},"七、失败案例：人工已经改过 CTA，Agent 后续生成又把它覆盖掉",{"type":26,"tag":27,"props":635,"children":636},{},[637],{"type":31,"value":638},"某个营销内容 agent 在人工修改 CTA 之后，另一个 review agent 仍然基于旧 draft version 继续生成“优化后的最终版”，系统直接按最后一次写入覆盖，结果人工改动消失。",{"type":26,"tag":27,"props":640,"children":641},{},[642],{"type":31,"value":643},"修复后，团队把所有后续 proposal 都必须携带 baseVersion，只要发现 proposal 基于旧版本，就进入 conflict gate 而不是直接落地，覆盖问题才消失。",{"type":26,"tag":76,"props":645,"children":647},{"id":646},"八输出合并与冲突解决-checklist",[648],{"type":31,"value":649},"八、输出合并与冲突解决 Checklist",{"type":26,"tag":395,"props":651,"children":654},{"className":652},[653],"contains-task-list",[655,668,677,686,695,704,713,722,731],{"type":26,"tag":399,"props":656,"children":659},{"className":657},[658],"task-list-item",[660,666],{"type":26,"tag":661,"props":662,"children":665},"input",{"disabled":663,"type":664},true,"checkbox",[],{"type":31,"value":667}," 是否先把不同来源的修改变成 merge proposal，而不是直接落最终状态",{"type":26,"tag":399,"props":669,"children":671},{"className":670},[658],[672,675],{"type":26,"tag":661,"props":673,"children":674},{"disabled":663,"type":664},[],{"type":31,"value":676}," 是否区分文本、字段和顺序三类冲突",{"type":26,"tag":399,"props":678,"children":680},{"className":679},[658],[681,684],{"type":26,"tag":661,"props":682,"children":683},{"disabled":663,"type":664},[],{"type":31,"value":685}," 是否为冲突显式定义 low / medium / high / critical 等级",{"type":26,"tag":399,"props":687,"children":689},{"className":688},[658],[690,693],{"type":26,"tag":661,"props":691,"children":692},{"disabled":663,"type":664},[],{"type":31,"value":694}," 自动合并边界是否避开高风险状态字段",{"type":26,"tag":399,"props":696,"children":698},{"className":697},[658],[699,702],{"type":26,"tag":661,"props":700,"children":701},{"disabled":663,"type":664},[],{"type":31,"value":703}," 是否先检查状态冲突，再处理文本冲突",{"type":26,"tag":399,"props":705,"children":707},{"className":706},[658],[708,711],{"type":26,"tag":661,"props":709,"children":710},{"disabled":663,"type":664},[],{"type":31,"value":712}," human merge gate 是否展示 base version、来源、意图和副作用",{"type":26,"tag":399,"props":714,"children":716},{"className":715},[658],[717,720],{"type":26,"tag":661,"props":718,"children":719},{"disabled":663,"type":664},[],{"type":31,"value":721}," merge decision 是否被记录，而不是只留下最终结果",{"type":26,"tag":399,"props":723,"children":725},{"className":724},[658],[726,729],{"type":26,"tag":661,"props":727,"children":728},{"disabled":663,"type":664},[],{"type":31,"value":730}," proposal 是否都带 baseVersion 防止旧版本写回",{"type":26,"tag":399,"props":732,"children":734},{"className":733},[658],[735,738],{"type":26,"tag":661,"props":736,"children":737},{"disabled":663,"type":664},[],{"type":31,"value":739}," 是否监控 auto-merge 成功率和 post-merge rollback rate",{"type":26,"tag":76,"props":741,"children":743},{"id":742},"结语",[744],{"type":31,"value":742},{"type":26,"tag":27,"props":746,"children":747},{},[748],{"type":31,"value":749},"AI agent 的多路输出问题，本质上不是“怎么把几段文本拼起来”，而是怎么让不同来源的修改在同一套版本、责任和风险边界内收口。只有 merge proposal、conflict class 和 human merge gate 同时存在，系统才不会在最后一步把前面所有工程治理都冲掉。",{"type":26,"tag":27,"props":751,"children":752},{},[753],{"type":31,"value":754},"延伸阅读：",{"type":26,"tag":395,"props":756,"children":757},{},[758,765,772,779],{"type":26,"tag":399,"props":759,"children":760},{},[761],{"type":26,"tag":44,"props":762,"children":763},{"href":46},[764],{"type":31,"value":49},{"type":26,"tag":399,"props":766,"children":767},{},[768],{"type":26,"tag":44,"props":769,"children":770},{"href":54},[771],{"type":31,"value":57},{"type":26,"tag":399,"props":773,"children":774},{},[775],{"type":26,"tag":44,"props":776,"children":777},{"href":61},[778],{"type":31,"value":64},{"type":26,"tag":399,"props":780,"children":781},{},[782],{"type":26,"tag":44,"props":783,"children":784},{"href":69},[785],{"type":31,"value":72},{"title":7,"searchDepth":787,"depth":787,"links":788},3,[789,791,792,793,794,795,796,797,798,799],{"id":78,"depth":790,"text":81},2,{"id":156,"depth":790,"text":159},{"id":248,"depth":790,"text":251},{"id":385,"depth":790,"text":388},{"id":421,"depth":790,"text":424},{"id":456,"depth":790,"text":459},{"id":514,"depth":790,"text":517},{"id":630,"depth":790,"text":633},{"id":646,"depth":790,"text":649},{"id":742,"depth":790,"text":742},"markdown","content:topics:ai:ai-agent-output-merge-conflict-resolution.md","content","topics/ai/ai-agent-output-merge-conflict-resolution.md","topics/ai/ai-agent-output-merge-conflict-resolution","md",[807,1961,2910],{"_path":808,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":809,"description":810,"date":811,"topic":5,"author":11,"tags":812,"image":818,"imageAlt":819,"pexelsPhotoId":820,"pexelsUrl":821,"readingTime":822,"body":823,"_type":800,"_id":1958,"_source":802,"_file":1959,"_stem":1960,"_extension":805},"/topics/ai/cursor-keyboard-shortcuts-cheatsheet","Cursor 快捷键速查表（macOS/Windows）：从“会用”到“能提效”的 10 个工作流","把 Cursor 常用快捷键按任务分组（查代码、改代码、多文件、对话、审查与回滚），给出可直接照抄的工作流与最小回归清单，避免“快捷键背了也没变快”。","2026-03-02",[813,814,815,816,817],"Cursor","快捷键","AI IDE","VS Code","开发效率","/images/topics/ai/cursor-keyboard-shortcuts-cheatsheet.jpg","彩色机械键盘与鼠标的工作台面",34563105,"https://www.pexels.com/photo/colorful-mechanical-keyboard-and-mouse-setup-34563105/",12,{"type":23,"children":824,"toc":1932},[825,830,848,853,881,886,922,926,932,937,970,975,998,1001,1007,1012,1230,1239,1242,1248,1255,1274,1282,1303,1308,1314,1329,1360,1365,1378,1384,1403,1421,1429,1434,1440,1445,1466,1474,1480,1485,1508,1513,1519,1532,1538,1556,1574,1580,1591,1609,1615,1626,1632,1637,1680,1683,1689,1697,1750,1753,1759,1765,1770,1775,1798,1816,1821,1846,1849,1855,1861,1866,1872,1877,1883,1888,1891,1897],{"type":26,"tag":27,"props":826,"children":827},{},[828],{"type":31,"value":829},"如果你在搜“Cursor 快捷键”，你大概率不是想背一张表，而是想解决这类问题：",{"type":26,"tag":395,"props":831,"children":832},{},[833,838,843],{"type":26,"tag":399,"props":834,"children":835},{},[836],{"type":31,"value":837},"为什么我用了 AI，还是很慢？（对话来回太多、改动不可控）",{"type":26,"tag":399,"props":839,"children":840},{},[841],{"type":31,"value":842},"为什么它“看起来懂了”，却改错文件/改出回归？（上下文与范围没锁住）",{"type":26,"tag":399,"props":844,"children":845},{},[846],{"type":31,"value":847},"多文件改动怎么做得安全？（验收、回滚、最小回归集）",{"type":26,"tag":27,"props":849,"children":850},{},[851],{"type":31,"value":852},"这篇文章给你两份东西：",{"type":26,"tag":431,"props":854,"children":855},{},[856,869],{"type":26,"tag":399,"props":857,"children":858},{},[859,861,867],{"type":31,"value":860},"一张",{"type":26,"tag":862,"props":863,"children":864},"strong",{},[865],{"type":31,"value":866},"按任务分组",{"type":31,"value":868},"的快捷键表（不是按功能堆在一起）",{"type":26,"tag":399,"props":870,"children":871},{},[872,874,879],{"type":31,"value":873},"一套“从需求到落地”的",{"type":26,"tag":862,"props":875,"children":876},{},[877],{"type":31,"value":878},"最小闭环工作流",{"type":31,"value":880},"（每一步都有快捷键）",{"type":26,"tag":27,"props":882,"children":883},{},[884],{"type":31,"value":885},"想看系统玩法：",{"type":26,"tag":395,"props":887,"children":888},{},[889,900,911],{"type":26,"tag":399,"props":890,"children":891},{},[892,894],{"type":31,"value":893},"入门教程看：",{"type":26,"tag":44,"props":895,"children":897},{"href":896},"/topics/ai/cursor-tutorial",[898],{"type":31,"value":899},"Cursor 使用教程（2026）",{"type":26,"tag":399,"props":901,"children":902},{},[903,905],{"type":31,"value":904},"进阶玩法看：",{"type":26,"tag":44,"props":906,"children":908},{"href":907},"/topics/ai/cursor-editor-guide",[909],{"type":31,"value":910},"Cursor 编辑器深度玩法",{"type":26,"tag":399,"props":912,"children":913},{},[914,916],{"type":31,"value":915},"规则与忽略看：",{"type":26,"tag":44,"props":917,"children":919},{"href":918},"/topics/ai/cursor-rules-cursorrules",[920],{"type":31,"value":921},"Cursor Rules 与 .cursorrules",{"type":26,"tag":923,"props":924,"children":925},"hr",{},[],{"type":26,"tag":76,"props":927,"children":929},{"id":928},"先给结论提效不是按得快而是闭环更短",[930],{"type":31,"value":931},"先给结论：提效不是“按得快”，而是“闭环更短”",{"type":26,"tag":27,"props":933,"children":934},{},[935],{"type":31,"value":936},"你可以把 Cursor 的快捷键理解为 3 条流水线：",{"type":26,"tag":395,"props":938,"children":939},{},[940,950,960],{"type":26,"tag":399,"props":941,"children":942},{},[943,948],{"type":26,"tag":862,"props":944,"children":945},{},[946],{"type":31,"value":947},"改一小段",{"type":31,"value":949},"（内联编辑）：把改动限制在一个函数/一段样式",{"type":26,"tag":399,"props":951,"children":952},{},[953,958],{"type":26,"tag":862,"props":954,"children":955},{},[956],{"type":31,"value":957},"改一组文件",{"type":31,"value":959},"（Composer）：把改动限制在一组明确文件，并要求输出 diff + 验收点",{"type":26,"tag":399,"props":961,"children":962},{},[963,968],{"type":26,"tag":862,"props":964,"children":965},{},[966],{"type":31,"value":967},"聊清楚再动手",{"type":31,"value":969},"（侧边对话）：先对齐目标、范围、验收、回滚",{"type":26,"tag":27,"props":971,"children":972},{},[973],{"type":31,"value":974},"当你觉得“它乱改/改太大”时，往往不是快捷键没记住，而是缺了两件事：",{"type":26,"tag":395,"props":976,"children":977},{},[978,988],{"type":26,"tag":399,"props":979,"children":980},{},[981,983],{"type":31,"value":982},"没有在动手前锁定",{"type":26,"tag":862,"props":984,"children":985},{},[986],{"type":31,"value":987},"范围",{"type":26,"tag":399,"props":989,"children":990},{},[991,993],{"type":31,"value":992},"没有在接受改动前准备",{"type":26,"tag":862,"props":994,"children":995},{},[996],{"type":31,"value":997},"验收/回滚",{"type":26,"tag":923,"props":999,"children":1000},{},[],{"type":26,"tag":76,"props":1002,"children":1004},{"id":1003},"快捷键速查表按任务分组",[1005],{"type":31,"value":1006},"快捷键速查表（按任务分组）",{"type":26,"tag":27,"props":1008,"children":1009},{},[1010],{"type":31,"value":1011},"说明：下表按“你正在做什么”组织，而不是按“功能名字”组织。不同版本快捷键可能略有差异，但核心逻辑一致。",{"type":26,"tag":83,"props":1013,"children":1014},{},[1015,1041],{"type":26,"tag":87,"props":1016,"children":1017},{},[1018],{"type":26,"tag":91,"props":1019,"children":1020},{},[1021,1026,1031,1036],{"type":26,"tag":95,"props":1022,"children":1023},{},[1024],{"type":31,"value":1025},"任务",{"type":26,"tag":95,"props":1027,"children":1028},{},[1029],{"type":31,"value":1030},"macOS",{"type":26,"tag":95,"props":1032,"children":1033},{},[1034],{"type":31,"value":1035},"Windows",{"type":26,"tag":95,"props":1037,"children":1038},{},[1039],{"type":31,"value":1040},"你该在什么时候用",{"type":26,"tag":106,"props":1042,"children":1043},{},[1044,1075,1106,1137,1168,1199],{"type":26,"tag":91,"props":1045,"children":1046},{},[1047,1052,1061,1070],{"type":26,"tag":113,"props":1048,"children":1049},{},[1050],{"type":31,"value":1051},"改一小段（最安全）",{"type":26,"tag":113,"props":1053,"children":1054},{},[1055],{"type":26,"tag":214,"props":1056,"children":1058},{"className":1057},[],[1059],{"type":31,"value":1060},"Cmd + K",{"type":26,"tag":113,"props":1062,"children":1063},{},[1064],{"type":26,"tag":214,"props":1065,"children":1067},{"className":1066},[],[1068],{"type":31,"value":1069},"Ctrl + K",{"type":26,"tag":113,"props":1071,"children":1072},{},[1073],{"type":31,"value":1074},"只想改一个函数/一段 CSS，不想动别的",{"type":26,"tag":91,"props":1076,"children":1077},{},[1078,1083,1092,1101],{"type":26,"tag":113,"props":1079,"children":1080},{},[1081],{"type":31,"value":1082},"打开 AI 对话（先对齐再动手）",{"type":26,"tag":113,"props":1084,"children":1085},{},[1086],{"type":26,"tag":214,"props":1087,"children":1089},{"className":1088},[],[1090],{"type":31,"value":1091},"Cmd + L",{"type":26,"tag":113,"props":1093,"children":1094},{},[1095],{"type":26,"tag":214,"props":1096,"children":1098},{"className":1097},[],[1099],{"type":31,"value":1100},"Ctrl + L",{"type":26,"tag":113,"props":1102,"children":1103},{},[1104],{"type":31,"value":1105},"需要澄清目标、制定步骤、给验收点",{"type":26,"tag":91,"props":1107,"children":1108},{},[1109,1114,1123,1132],{"type":26,"tag":113,"props":1110,"children":1111},{},[1112],{"type":31,"value":1113},"多文件编辑（有组织地改一组文件）",{"type":26,"tag":113,"props":1115,"children":1116},{},[1117],{"type":26,"tag":214,"props":1118,"children":1120},{"className":1119},[],[1121],{"type":31,"value":1122},"Cmd + I",{"type":26,"tag":113,"props":1124,"children":1125},{},[1126],{"type":26,"tag":214,"props":1127,"children":1129},{"className":1128},[],[1130],{"type":31,"value":1131},"Ctrl + I",{"type":26,"tag":113,"props":1133,"children":1134},{},[1135],{"type":31,"value":1136},"改动涉及多个文件：组件+样式+测试",{"type":26,"tag":91,"props":1138,"children":1139},{},[1140,1145,1154,1163],{"type":26,"tag":113,"props":1141,"children":1142},{},[1143],{"type":31,"value":1144},"把选中代码加入对话上下文",{"type":26,"tag":113,"props":1146,"children":1147},{},[1148],{"type":26,"tag":214,"props":1149,"children":1151},{"className":1150},[],[1152],{"type":31,"value":1153},"Cmd + Shift + L",{"type":26,"tag":113,"props":1155,"children":1156},{},[1157],{"type":26,"tag":214,"props":1158,"children":1160},{"className":1159},[],[1161],{"type":31,"value":1162},"Ctrl + Shift + L",{"type":26,"tag":113,"props":1164,"children":1165},{},[1166],{"type":31,"value":1167},"让 AI 只看你选的片段（降低噪音）",{"type":26,"tag":91,"props":1169,"children":1170},{},[1171,1176,1185,1194],{"type":26,"tag":113,"props":1172,"children":1173},{},[1174],{"type":31,"value":1175},"接受当前建议",{"type":26,"tag":113,"props":1177,"children":1178},{},[1179],{"type":26,"tag":214,"props":1180,"children":1182},{"className":1181},[],[1183],{"type":31,"value":1184},"Cmd + Y",{"type":26,"tag":113,"props":1186,"children":1187},{},[1188],{"type":26,"tag":214,"props":1189,"children":1191},{"className":1190},[],[1192],{"type":31,"value":1193},"Ctrl + Y",{"type":26,"tag":113,"props":1195,"children":1196},{},[1197],{"type":31,"value":1198},"你已经准备好验收/回滚，并确认改动范围",{"type":26,"tag":91,"props":1200,"children":1201},{},[1202,1207,1216,1225],{"type":26,"tag":113,"props":1203,"children":1204},{},[1205],{"type":31,"value":1206},"拒绝当前建议",{"type":26,"tag":113,"props":1208,"children":1209},{},[1210],{"type":26,"tag":214,"props":1211,"children":1213},{"className":1212},[],[1214],{"type":31,"value":1215},"Cmd + N",{"type":26,"tag":113,"props":1217,"children":1218},{},[1219],{"type":26,"tag":214,"props":1220,"children":1222},{"className":1221},[],[1223],{"type":31,"value":1224},"Ctrl + N",{"type":26,"tag":113,"props":1226,"children":1227},{},[1228],{"type":31,"value":1229},"改得太大、改错方向，立刻收手",{"type":26,"tag":1231,"props":1232,"children":1233},"blockquote",{},[1234],{"type":26,"tag":27,"props":1235,"children":1236},{},[1237],{"type":31,"value":1238},"小技巧：把“改一小段”当默认路径。只有当你能清晰写出“会改哪几类文件、怎么验收”时再进入多文件。",{"type":26,"tag":923,"props":1240,"children":1241},{},[],{"type":26,"tag":76,"props":1243,"children":1245},{"id":1244},"_10-个可直接照抄的提效工作流每个都能闭环",[1246],{"type":31,"value":1247},"10 个可直接照抄的提效工作流（每个都能闭环）",{"type":26,"tag":1249,"props":1250,"children":1252},"h3",{"id":1251},"工作流-1需求计划小步改新手最稳",[1253],{"type":31,"value":1254},"工作流 1：需求→计划→小步改（新手最稳）",{"type":26,"tag":431,"props":1256,"children":1257},{},[1258,1269],{"type":26,"tag":399,"props":1259,"children":1260},{},[1261,1267],{"type":26,"tag":214,"props":1262,"children":1264},{"className":1263},[],[1265],{"type":31,"value":1266},"Cmd/Ctrl + L",{"type":31,"value":1268}," 打开对话",{"type":26,"tag":399,"props":1270,"children":1271},{},[1272],{"type":31,"value":1273},"先发这段（可复制）：",{"type":26,"tag":1231,"props":1275,"children":1276},{},[1277],{"type":26,"tag":27,"props":1278,"children":1279},{},[1280],{"type":31,"value":1281},"目标：……\n范围：只修改以下文件/模块：……\n非目标：……（明确不做）\n验收：……（可测试/可手动检查）\n输出格式：先给计划，再逐步执行；每一步写出 diff 摘要。",{"type":26,"tag":431,"props":1283,"children":1284},{"start":787},[1285,1290],{"type":26,"tag":399,"props":1286,"children":1287},{},[1288],{"type":31,"value":1289},"让 AI 先给“计划（3~6 步）”，你确认后再执行",{"type":26,"tag":399,"props":1291,"children":1292},{},[1293,1295,1301],{"type":31,"value":1294},"任何一步涉及改代码：优先回到编辑区，选中片段用 ",{"type":26,"tag":214,"props":1296,"children":1298},{"className":1297},[],[1299],{"type":31,"value":1300},"Cmd/Ctrl + K",{"type":31,"value":1302}," 小步改",{"type":26,"tag":27,"props":1304,"children":1305},{},[1306],{"type":31,"value":1307},"为什么有效：你把“想法”变成了“可执行约束”，这就是 GEO（面向 AI/模型的可理解结构）。",{"type":26,"tag":1249,"props":1309,"children":1311},{"id":1310},"工作流-2只改一个函数高频低风险",[1312],{"type":31,"value":1313},"工作流 2：只改一个函数（高频、低风险）",{"type":26,"tag":395,"props":1315,"children":1316},{},[1317],{"type":26,"tag":399,"props":1318,"children":1319},{},[1320,1322,1327],{"type":31,"value":1321},"选中函数 → ",{"type":26,"tag":214,"props":1323,"children":1325},{"className":1324},[],[1326],{"type":31,"value":1300},{"type":31,"value":1328}," → 输入指令：",{"type":26,"tag":1231,"props":1330,"children":1331},{},[1332,1337],{"type":26,"tag":27,"props":1333,"children":1334},{},[1335],{"type":31,"value":1336},"把这段改成更可读：",{"type":26,"tag":395,"props":1338,"children":1339},{},[1340,1345,1350,1355],{"type":26,"tag":399,"props":1341,"children":1342},{},[1343],{"type":31,"value":1344},"用 async/await",{"type":26,"tag":399,"props":1346,"children":1347},{},[1348],{"type":31,"value":1349},"错误处理不要吞掉",{"type":26,"tag":399,"props":1351,"children":1352},{},[1353],{"type":31,"value":1354},"添加类型（若可推断）",{"type":26,"tag":399,"props":1356,"children":1357},{},[1358],{"type":31,"value":1359},"不要改函数签名",{"type":26,"tag":27,"props":1361,"children":1362},{},[1363],{"type":31,"value":1364},"验收方式（强制）：",{"type":26,"tag":395,"props":1366,"children":1367},{},[1368,1373],{"type":26,"tag":399,"props":1369,"children":1370},{},[1371],{"type":31,"value":1372},"输出前后函数行为一致（输入/输出）",{"type":26,"tag":399,"props":1374,"children":1375},{},[1376],{"type":31,"value":1377},"失败分支有可观测日志（不要悄悄 return null）",{"type":26,"tag":1249,"props":1379,"children":1381},{"id":1380},"工作流-3多文件改动先定文件清单",[1382],{"type":31,"value":1383},"工作流 3：多文件改动（先定“文件清单”）",{"type":26,"tag":431,"props":1385,"children":1386},{},[1387,1398],{"type":26,"tag":399,"props":1388,"children":1389},{},[1390,1396],{"type":26,"tag":214,"props":1391,"children":1393},{"className":1392},[],[1394],{"type":31,"value":1395},"Cmd/Ctrl + I",{"type":31,"value":1397}," 进入多文件",{"type":26,"tag":399,"props":1399,"children":1400},{},[1401],{"type":31,"value":1402},"先让 AI 输出：",{"type":26,"tag":395,"props":1404,"children":1405},{},[1406,1411,1416],{"type":26,"tag":399,"props":1407,"children":1408},{},[1409],{"type":31,"value":1410},"预计会改哪些文件（最多 5 个）",{"type":26,"tag":399,"props":1412,"children":1413},{},[1414],{"type":31,"value":1415},"每个文件改什么",{"type":26,"tag":399,"props":1417,"children":1418},{},[1419],{"type":31,"value":1420},"每一步怎么验收",{"type":26,"tag":431,"props":1422,"children":1423},{"start":787},[1424],{"type":26,"tag":399,"props":1425,"children":1426},{},[1427],{"type":31,"value":1428},"你确认文件清单后再开始生成改动",{"type":26,"tag":27,"props":1430,"children":1431},{},[1432],{"type":31,"value":1433},"关键点：多文件最容易翻车的是“它把你没想到的文件也改了”。所以文件清单是第一道闸门。",{"type":26,"tag":1249,"props":1435,"children":1437},{"id":1436},"工作流-4把上下文噪音砍掉防跑偏",[1438],{"type":31,"value":1439},"工作流 4：把“上下文噪音”砍掉（防跑偏）",{"type":26,"tag":27,"props":1441,"children":1442},{},[1443],{"type":31,"value":1444},"当你怀疑它在胡说/乱改时：",{"type":26,"tag":395,"props":1446,"children":1447},{},[1448,1461],{"type":26,"tag":399,"props":1449,"children":1450},{},[1451,1453,1459],{"type":31,"value":1452},"只选择关键代码片段 → ",{"type":26,"tag":214,"props":1454,"children":1456},{"className":1455},[],[1457],{"type":31,"value":1458},"Cmd/Ctrl + Shift + L",{"type":31,"value":1460}," 加入对话",{"type":26,"tag":399,"props":1462,"children":1463},{},[1464],{"type":31,"value":1465},"然后在对话里要求：",{"type":26,"tag":1231,"props":1467,"children":1468},{},[1469],{"type":26,"tag":27,"props":1470,"children":1471},{},[1472],{"type":31,"value":1473},"只基于我提供的代码片段回答，不要假设其它文件存在。",{"type":26,"tag":1249,"props":1475,"children":1477},{"id":1476},"工作流-5生成变更说明让-code-review-变快",[1478],{"type":31,"value":1479},"工作流 5：生成变更说明（让 code review 变快）",{"type":26,"tag":27,"props":1481,"children":1482},{},[1483],{"type":31,"value":1484},"改完后在对话里让它输出：",{"type":26,"tag":395,"props":1486,"children":1487},{},[1488,1493,1498,1503],{"type":26,"tag":399,"props":1489,"children":1490},{},[1491],{"type":31,"value":1492},"改动摘要（3~7 条）",{"type":26,"tag":399,"props":1494,"children":1495},{},[1496],{"type":31,"value":1497},"风险点（依赖/边界条件）",{"type":26,"tag":399,"props":1499,"children":1500},{},[1501],{"type":31,"value":1502},"回滚方式",{"type":26,"tag":399,"props":1504,"children":1505},{},[1506],{"type":31,"value":1507},"验收步骤",{"type":26,"tag":27,"props":1509,"children":1510},{},[1511],{"type":31,"value":1512},"这套结构能直接贴进 PR 描述。",{"type":26,"tag":1249,"props":1514,"children":1516},{"id":1515},"工作流-6写最小回归集不写回归-等事故",[1517],{"type":31,"value":1518},"工作流 6：写“最小回归集”（不写回归 = 等事故）",{"type":26,"tag":27,"props":1520,"children":1521},{},[1522,1524,1530],{"type":31,"value":1523},"每次改动都至少做 10 条最小回归（见下文清单）。你可以把它写在 ",{"type":26,"tag":214,"props":1525,"children":1527},{"className":1526},[],[1528],{"type":31,"value":1529},"README",{"type":31,"value":1531}," 或团队 wiki。",{"type":26,"tag":1249,"props":1533,"children":1535},{"id":1534},"工作流-7把接受建议变成最后一步",[1536],{"type":31,"value":1537},"工作流 7：把“接受建议”变成最后一步",{"type":26,"tag":27,"props":1539,"children":1540},{},[1541,1547,1549,1554],{"type":26,"tag":214,"props":1542,"children":1544},{"className":1543},[],[1545],{"type":31,"value":1546},"Cmd/Ctrl + Y",{"type":31,"value":1548}," 应该是",{"type":26,"tag":862,"props":1550,"children":1551},{},[1552],{"type":31,"value":1553},"最后一步",{"type":31,"value":1555},"：",{"type":26,"tag":395,"props":1557,"children":1558},{},[1559,1564,1569],{"type":26,"tag":399,"props":1560,"children":1561},{},[1562],{"type":31,"value":1563},"你已经看过 diff",{"type":26,"tag":399,"props":1565,"children":1566},{},[1567],{"type":31,"value":1568},"你能说清楚“怎么验收”",{"type":26,"tag":399,"props":1570,"children":1571},{},[1572],{"type":31,"value":1573},"你知道“怎么回滚”",{"type":26,"tag":1249,"props":1575,"children":1577},{"id":1576},"工作流-8拒绝建议不是失败是风控动作",[1578],{"type":31,"value":1579},"工作流 8：拒绝建议不是失败，是风控动作",{"type":26,"tag":27,"props":1581,"children":1582},{},[1583,1589],{"type":26,"tag":214,"props":1584,"children":1586},{"className":1585},[],[1587],{"type":31,"value":1588},"Cmd/Ctrl + N",{"type":31,"value":1590}," 的使用时机：",{"type":26,"tag":395,"props":1592,"children":1593},{},[1594,1599,1604],{"type":26,"tag":399,"props":1595,"children":1596},{},[1597],{"type":31,"value":1598},"它开始改你没提过的东西（范围漂移）",{"type":26,"tag":399,"props":1600,"children":1601},{},[1602],{"type":31,"value":1603},"它改了 10 个文件但你只想改 1 个",{"type":26,"tag":399,"props":1605,"children":1606},{},[1607],{"type":31,"value":1608},"它为了“更优雅”引入新依赖/新抽象",{"type":26,"tag":1249,"props":1610,"children":1612},{"id":1611},"工作流-9重复任务做成模板提示词不是一次性",[1613],{"type":31,"value":1614},"工作流 9：重复任务做成模板（提示词不是一次性）",{"type":26,"tag":27,"props":1616,"children":1617},{},[1618,1620,1624],{"type":31,"value":1619},"把高频任务（比如“写组件+样式+验收”）固化成模板，放进 Rules（见：",{"type":26,"tag":44,"props":1621,"children":1622},{"href":918},[1623],{"type":31,"value":921},{"type":31,"value":1625},"）。",{"type":26,"tag":1249,"props":1627,"children":1629},{"id":1628},"工作流-10把快捷键表做成你自己的任务表",[1630],{"type":31,"value":1631},"工作流 10：把“快捷键表”做成你自己的任务表",{"type":26,"tag":27,"props":1633,"children":1634},{},[1635],{"type":31,"value":1636},"你不需要记住所有快捷键，只需要记住：",{"type":26,"tag":395,"props":1638,"children":1639},{},[1640,1650,1660,1670],{"type":26,"tag":399,"props":1641,"children":1642},{},[1643,1645],{"type":31,"value":1644},"小步改：",{"type":26,"tag":214,"props":1646,"children":1648},{"className":1647},[],[1649],{"type":31,"value":1300},{"type":26,"tag":399,"props":1651,"children":1652},{},[1653,1655],{"type":31,"value":1654},"先对齐：",{"type":26,"tag":214,"props":1656,"children":1658},{"className":1657},[],[1659],{"type":31,"value":1266},{"type":26,"tag":399,"props":1661,"children":1662},{},[1663,1665],{"type":31,"value":1664},"多文件：",{"type":26,"tag":214,"props":1666,"children":1668},{"className":1667},[],[1669],{"type":31,"value":1395},{"type":26,"tag":399,"props":1671,"children":1672},{},[1673,1675],{"type":31,"value":1674},"上下文聚焦：",{"type":26,"tag":214,"props":1676,"children":1678},{"className":1677},[],[1679],{"type":31,"value":1458},{"type":26,"tag":923,"props":1681,"children":1682},{},[],{"type":26,"tag":76,"props":1684,"children":1686},{"id":1685},"必交付物-1最小回归任务清单10-条通用",[1687],{"type":31,"value":1688},"必交付物 1：最小回归任务清单（10 条，通用）",{"type":26,"tag":1231,"props":1690,"children":1691},{},[1692],{"type":26,"tag":27,"props":1693,"children":1694},{},[1695],{"type":31,"value":1696},"这份清单的意义：让每次 AI 改动都能“被验证”。否则你只是把不可控变成了更快的不可控。",{"type":26,"tag":431,"props":1698,"children":1699},{},[1700,1705,1710,1715,1720,1725,1730,1735,1740,1745],{"type":26,"tag":399,"props":1701,"children":1702},{},[1703],{"type":31,"value":1704},"关键路径能跑通（手动点击/请求一次）",{"type":26,"tag":399,"props":1706,"children":1707},{},[1708],{"type":31,"value":1709},"错误路径能触发（模拟一次失败输入）",{"type":26,"tag":399,"props":1711,"children":1712},{},[1713],{"type":31,"value":1714},"控制台无新增错误（至少关注 1 次真实操作）",{"type":26,"tag":399,"props":1716,"children":1717},{},[1718],{"type":31,"value":1719},"关键 UI 未错位（移动端/桌面端各看一眼）",{"type":26,"tag":399,"props":1721,"children":1722},{},[1723],{"type":31,"value":1724},"刷新后状态正确（尤其是表单/列表）",{"type":26,"tag":399,"props":1726,"children":1727},{},[1728],{"type":31,"value":1729},"路由跳转没断（从入口到目标页）",{"type":26,"tag":399,"props":1731,"children":1732},{},[1733],{"type":31,"value":1734},"相关接口未改变契约（字段名/类型）",{"type":26,"tag":399,"props":1736,"children":1737},{},[1738],{"type":31,"value":1739},"性能没有明显退化（首屏、交互卡顿）",{"type":26,"tag":399,"props":1741,"children":1742},{},[1743],{"type":31,"value":1744},"回滚方案可执行（知道回滚哪几个文件/commit）",{"type":26,"tag":399,"props":1746,"children":1747},{},[1748],{"type":31,"value":1749},"写下“这次改动解决了什么、风险是什么”（可贴 PR）",{"type":26,"tag":923,"props":1751,"children":1752},{},[],{"type":26,"tag":76,"props":1754,"children":1756},{"id":1755},"必交付物-2失败案例复盘真实会发生",[1757],{"type":31,"value":1758},"必交付物 2：失败案例复盘（真实会发生）",{"type":26,"tag":1249,"props":1760,"children":1762},{"id":1761},"现象快捷键用得很熟但交付还是慢",[1763],{"type":31,"value":1764},"现象：快捷键用得很熟，但交付还是慢",{"type":26,"tag":27,"props":1766,"children":1767},{},[1768],{"type":31,"value":1769},"典型原因：你把 Cursor 当成“更聪明的搜索框”，不断对话，直到它给出你想要的答案。",{"type":26,"tag":27,"props":1771,"children":1772},{},[1773],{"type":31,"value":1774},"复现路径：",{"type":26,"tag":395,"props":1776,"children":1777},{},[1778,1783,1788,1793],{"type":26,"tag":399,"props":1779,"children":1780},{},[1781],{"type":31,"value":1782},"你直接说“把页面做得更好看、更高级”",{"type":26,"tag":399,"props":1784,"children":1785},{},[1786],{"type":31,"value":1787},"AI 开始大改样式、抽象组件、甚至引入新依赖",{"type":26,"tag":399,"props":1789,"children":1790},{},[1791],{"type":31,"value":1792},"你为了省事按了“接受建议”",{"type":26,"tag":399,"props":1794,"children":1795},{},[1796],{"type":31,"value":1797},"最后发现：设计没统一、移动端崩、甚至埋了性能问题",{"type":26,"tag":27,"props":1799,"children":1800},{},[1801,1803,1807,1809,1814],{"type":31,"value":1802},"根因：缺少",{"type":26,"tag":862,"props":1804,"children":1805},{},[1806],{"type":31,"value":987},{"type":31,"value":1808},"与",{"type":26,"tag":862,"props":1810,"children":1811},{},[1812],{"type":31,"value":1813},"验收",{"type":31,"value":1815},"。",{"type":26,"tag":27,"props":1817,"children":1818},{},[1819],{"type":31,"value":1820},"修复方式（可照抄）：",{"type":26,"tag":395,"props":1822,"children":1823},{},[1824,1829,1841],{"type":26,"tag":399,"props":1825,"children":1826},{},[1827],{"type":31,"value":1828},"把需求拆成 3 个可验证目标：例如“按钮样式统一”“首屏 CTA 更明显”“移动端间距不挤”",{"type":26,"tag":399,"props":1830,"children":1831},{},[1832,1834,1839],{"type":31,"value":1833},"每个目标只用 ",{"type":26,"tag":214,"props":1835,"children":1837},{"className":1836},[],[1838],{"type":31,"value":1300},{"type":31,"value":1840}," 改一个局部",{"type":26,"tag":399,"props":1842,"children":1843},{},[1844],{"type":31,"value":1845},"每次接受建议前跑一遍“最小回归集”",{"type":26,"tag":923,"props":1847,"children":1848},{},[],{"type":26,"tag":76,"props":1850,"children":1852},{"id":1851},"faq高频问题",[1853],{"type":31,"value":1854},"FAQ（高频问题）",{"type":26,"tag":1249,"props":1856,"children":1858},{"id":1857},"q1我应该先记快捷键还是先学工作流",[1859],{"type":31,"value":1860},"Q1：我应该先记快捷键还是先学工作流？",{"type":26,"tag":27,"props":1862,"children":1863},{},[1864],{"type":31,"value":1865},"先学工作流。快捷键只是把工作流的步骤变短。",{"type":26,"tag":1249,"props":1867,"children":1869},{"id":1868},"q2为什么我一用多文件就容易翻车",[1870],{"type":31,"value":1871},"Q2：为什么我一用多文件就容易翻车？",{"type":26,"tag":27,"props":1873,"children":1874},{},[1875],{"type":31,"value":1876},"因为多文件意味着范围更大、依赖更多、验收更难。先锁定“文件清单 + 每步验收”，再让它动手。",{"type":26,"tag":1249,"props":1878,"children":1880},{"id":1879},"q3有没有万能提示词",[1881],{"type":31,"value":1882},"Q3：有没有“万能提示词”？",{"type":26,"tag":27,"props":1884,"children":1885},{},[1886],{"type":31,"value":1887},"没有，但有“万能结构”：目标、范围、非目标、验收、输出格式。",{"type":26,"tag":923,"props":1889,"children":1890},{},[],{"type":26,"tag":76,"props":1892,"children":1894},{"id":1893},"延伸阅读建议按顺序",[1895],{"type":31,"value":1896},"延伸阅读（建议按顺序）",{"type":26,"tag":395,"props":1898,"children":1899},{},[1900,1907,1914,1921],{"type":26,"tag":399,"props":1901,"children":1902},{},[1903],{"type":26,"tag":44,"props":1904,"children":1905},{"href":896},[1906],{"type":31,"value":899},{"type":26,"tag":399,"props":1908,"children":1909},{},[1910],{"type":26,"tag":44,"props":1911,"children":1912},{"href":907},[1913],{"type":31,"value":910},{"type":26,"tag":399,"props":1915,"children":1916},{},[1917],{"type":26,"tag":44,"props":1918,"children":1919},{"href":918},[1920],{"type":31,"value":921},{"type":26,"tag":399,"props":1922,"children":1923},{},[1924,1926],{"type":31,"value":1925},"如果你更关心“网页制作落地”：看这篇 ",{"type":26,"tag":44,"props":1927,"children":1929},{"href":1928},"/topics/practical-tips/htmlpage-quick-landing-page",[1930],{"type":31,"value":1931},"3 分钟用 HTMLPAGE 做落地页",{"title":7,"searchDepth":787,"depth":787,"links":1933},[1934,1935,1936,1948,1949,1952,1957],{"id":928,"depth":790,"text":931},{"id":1003,"depth":790,"text":1006},{"id":1244,"depth":790,"text":1247,"children":1937},[1938,1939,1940,1941,1942,1943,1944,1945,1946,1947],{"id":1251,"depth":787,"text":1254},{"id":1310,"depth":787,"text":1313},{"id":1380,"depth":787,"text":1383},{"id":1436,"depth":787,"text":1439},{"id":1476,"depth":787,"text":1479},{"id":1515,"depth":787,"text":1518},{"id":1534,"depth":787,"text":1537},{"id":1576,"depth":787,"text":1579},{"id":1611,"depth":787,"text":1614},{"id":1628,"depth":787,"text":1631},{"id":1685,"depth":790,"text":1688},{"id":1755,"depth":790,"text":1758,"children":1950},[1951],{"id":1761,"depth":787,"text":1764},{"id":1851,"depth":790,"text":1854,"children":1953},[1954,1955,1956],{"id":1857,"depth":787,"text":1860},{"id":1868,"depth":787,"text":1871},{"id":1879,"depth":787,"text":1882},{"id":1893,"depth":790,"text":1896},"content:topics:ai:cursor-keyboard-shortcuts-cheatsheet.md","topics/ai/cursor-keyboard-shortcuts-cheatsheet.md","topics/ai/cursor-keyboard-shortcuts-cheatsheet",{"_path":1962,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":1963,"description":1964,"date":1965,"topic":5,"author":11,"tags":1966,"image":1970,"imageAlt":1971,"pexelsPhotoId":1972,"pexelsUrl":1973,"readingTime":1974,"body":1975,"_type":800,"_id":2907,"_source":802,"_file":2908,"_stem":2909,"_extension":805},"/topics/ai/cursor-vs-copilot-vscode-workflow","Cursor vs GitHub Copilot vs VS Code：怎么选、怎么搭配、怎么把风险关在笼子里","用“任务类型×风险×验收成本”的选择矩阵解释 Cursor/Copilot/VS Code 的差异，并给出一套可落地的协作工作流（范围闸门、最小回归集、回滚策略）。","2026-03-01",[813,1967,816,1968,1969],"GitHub Copilot","AI 编程","工作流","/images/topics/ai/cursor-vs-copilot-vscode-workflow.jpg","团队在电脑前进行协作讨论",1181371,"https://www.pexels.com/photo/man-wearing-blue-dress-shirt-1181371/",15,{"type":23,"children":1976,"toc":2885},[1977,1982,1987,2005,2010,2028,2031,2037,2042,2073,2078,2081,2087,2095,2298,2306,2319,2322,2328,2334,2347,2352,2365,2371,2376,2409,2415,2420,2438,2441,2447,2452,2458,2463,2496,2502,2515,2520,2533,2539,2551,2557,2562,2575,2580,2583,2589,2594,2715,2718,2724,2734,2743,2761,2770,2778,2787,2805,2808,2814,2820,2825,2831,2836,2839,2844],{"type":26,"tag":27,"props":1978,"children":1979},{},[1980],{"type":31,"value":1981},"“Cursor 和 Copilot 到底有什么区别？”",{"type":26,"tag":27,"props":1983,"children":1984},{},[1985],{"type":31,"value":1986},"这个问题问得越早越好，因为你一旦把工具选错，后面所有痛苦都不是“提示词不够好”，而是：",{"type":26,"tag":395,"props":1988,"children":1989},{},[1990,1995,2000],{"type":26,"tag":399,"props":1991,"children":1992},{},[1993],{"type":31,"value":1994},"改动不可控（范围漂移、改错文件）",{"type":26,"tag":399,"props":1996,"children":1997},{},[1998],{"type":31,"value":1999},"验收成本爆炸（不知道要测什么）",{"type":26,"tag":399,"props":2001,"children":2002},{},[2003],{"type":31,"value":2004},"团队协作崩盘（没有闸门、没有回滚）",{"type":26,"tag":27,"props":2006,"children":2007},{},[2008],{"type":31,"value":2009},"这篇文章用一张选择矩阵 + 一套可执行工作流，帮你做到两件事：",{"type":26,"tag":431,"props":2011,"children":2012},{},[2013,2018],{"type":26,"tag":399,"props":2014,"children":2015},{},[2016],{"type":31,"value":2017},"知道什么时候用 Cursor、什么时候用 Copilot、什么时候“纯 VS Code 更快”",{"type":26,"tag":399,"props":2019,"children":2020},{},[2021,2023],{"type":31,"value":2022},"就算用 AI，也能把风险关在笼子里：",{"type":26,"tag":862,"props":2024,"children":2025},{},[2026],{"type":31,"value":2027},"可审查、可验证、可回滚",{"type":26,"tag":923,"props":2029,"children":2030},{},[],{"type":26,"tag":76,"props":2032,"children":2034},{"id":2033},"结论先说三者不是互斥而是分工",[2035],{"type":31,"value":2036},"结论先说：三者不是互斥，而是分工",{"type":26,"tag":27,"props":2038,"children":2039},{},[2040],{"type":31,"value":2041},"你可以把它们看成三层能力：",{"type":26,"tag":395,"props":2043,"children":2044},{},[2045,2054,2064],{"type":26,"tag":399,"props":2046,"children":2047},{},[2048,2052],{"type":26,"tag":862,"props":2049,"children":2050},{},[2051],{"type":31,"value":816},{"type":31,"value":2053},"：编辑器与生态（调试、插件、任务、终端、语言服务）",{"type":26,"tag":399,"props":2055,"children":2056},{},[2057,2062],{"type":26,"tag":862,"props":2058,"children":2059},{},[2060],{"type":31,"value":2061},"Copilot",{"type":31,"value":2063},"：代码补全与局部建议（“我正在写这一行/这一段”）",{"type":26,"tag":399,"props":2065,"children":2066},{},[2067,2071],{"type":26,"tag":862,"props":2068,"children":2069},{},[2070],{"type":31,"value":813},{"type":31,"value":2072},"：以项目为单位的 AI 协作（对话、索引、多文件编辑、规则）",{"type":26,"tag":27,"props":2074,"children":2075},{},[2076],{"type":31,"value":2077},"最常见的误区是：把“局部补全能力”当作“能做架构与多文件落地”。",{"type":26,"tag":923,"props":2079,"children":2080},{},[],{"type":26,"tag":76,"props":2082,"children":2084},{"id":2083},"选择矩阵按任务类型选工具不是按偏好",[2085],{"type":31,"value":2086},"选择矩阵：按任务类型选工具（不是按偏好）",{"type":26,"tag":1231,"props":2088,"children":2089},{},[2090],{"type":26,"tag":27,"props":2091,"children":2092},{},[2093],{"type":31,"value":2094},"你只要把自己的任务放进表格，就能得到推荐路径。",{"type":26,"tag":83,"props":2096,"children":2097},{},[2098,2129],{"type":26,"tag":87,"props":2099,"children":2100},{},[2101],{"type":26,"tag":91,"props":2102,"children":2103},{},[2104,2109,2114,2119,2124],{"type":26,"tag":95,"props":2105,"children":2106},{},[2107],{"type":31,"value":2108},"任务类型",{"type":26,"tag":95,"props":2110,"children":2112},{"align":2111},"right",[2113],{"type":31,"value":104},{"type":26,"tag":95,"props":2115,"children":2116},{"align":2111},[2117],{"type":31,"value":2118},"验收成本",{"type":26,"tag":95,"props":2120,"children":2121},{},[2122],{"type":31,"value":2123},"更推荐",{"type":26,"tag":95,"props":2125,"children":2126},{},[2127],{"type":31,"value":2128},"为什么",{"type":26,"tag":106,"props":2130,"children":2131},{},[2132,2159,2192,2218,2245,2272],{"type":26,"tag":91,"props":2133,"children":2134},{},[2135,2140,2145,2149,2154],{"type":26,"tag":113,"props":2136,"children":2137},{},[2138],{"type":31,"value":2139},"写一段代码/补一个 if",{"type":26,"tag":113,"props":2141,"children":2142},{"align":2111},[2143],{"type":31,"value":2144},"低",{"type":26,"tag":113,"props":2146,"children":2147},{"align":2111},[2148],{"type":31,"value":2144},{"type":26,"tag":113,"props":2150,"children":2151},{},[2152],{"type":31,"value":2153},"Copilot / Cursor 内联编辑",{"type":26,"tag":113,"props":2155,"children":2156},{},[2157],{"type":31,"value":2158},"局部建议足够，成本最低",{"type":26,"tag":91,"props":2160,"children":2161},{},[2162,2167,2172,2176,2187],{"type":26,"tag":113,"props":2163,"children":2164},{},[2165],{"type":31,"value":2166},"重构一个函数",{"type":26,"tag":113,"props":2168,"children":2169},{"align":2111},[2170],{"type":31,"value":2171},"中",{"type":26,"tag":113,"props":2173,"children":2174},{"align":2111},[2175],{"type":31,"value":2171},{"type":26,"tag":113,"props":2177,"children":2178},{},[2179,2181],{"type":31,"value":2180},"Cursor ",{"type":26,"tag":214,"props":2182,"children":2184},{"className":2183},[],[2185],{"type":31,"value":2186},"内联编辑",{"type":26,"tag":113,"props":2188,"children":2189},{},[2190],{"type":31,"value":2191},"需要解释、需要约束输出",{"type":26,"tag":91,"props":2193,"children":2194},{},[2195,2200,2204,2208,2213],{"type":26,"tag":113,"props":2196,"children":2197},{},[2198],{"type":31,"value":2199},"改一个组件 + 样式",{"type":26,"tag":113,"props":2201,"children":2202},{"align":2111},[2203],{"type":31,"value":2171},{"type":26,"tag":113,"props":2205,"children":2206},{"align":2111},[2207],{"type":31,"value":2171},{"type":26,"tag":113,"props":2209,"children":2210},{},[2211],{"type":31,"value":2212},"Cursor（小范围多文件）",{"type":26,"tag":113,"props":2214,"children":2215},{},[2216],{"type":31,"value":2217},"需要同时改模板与样式",{"type":26,"tag":91,"props":2219,"children":2220},{},[2221,2226,2231,2235,2240],{"type":26,"tag":113,"props":2222,"children":2223},{},[2224],{"type":31,"value":2225},"改 3~5 个文件（组件+api+测试）",{"type":26,"tag":113,"props":2227,"children":2228},{"align":2111},[2229],{"type":31,"value":2230},"高",{"type":26,"tag":113,"props":2232,"children":2233},{"align":2111},[2234],{"type":31,"value":2230},{"type":26,"tag":113,"props":2236,"children":2237},{},[2238],{"type":31,"value":2239},"Cursor Composer + 闸门",{"type":26,"tag":113,"props":2241,"children":2242},{},[2243],{"type":31,"value":2244},"需要计划、验收、回滚",{"type":26,"tag":91,"props":2246,"children":2247},{},[2248,2253,2258,2262,2267],{"type":26,"tag":113,"props":2249,"children":2250},{},[2251],{"type":31,"value":2252},"重写一段架构/引入新依赖",{"type":26,"tag":113,"props":2254,"children":2255},{"align":2111},[2256],{"type":31,"value":2257},"很高",{"type":26,"tag":113,"props":2259,"children":2260},{"align":2111},[2261],{"type":31,"value":2257},{"type":26,"tag":113,"props":2263,"children":2264},{},[2265],{"type":31,"value":2266},"先人脑设计 + VS Code 实现",{"type":26,"tag":113,"props":2268,"children":2269},{},[2270],{"type":31,"value":2271},"AI 易发散，最好先设计再执行",{"type":26,"tag":91,"props":2273,"children":2274},{},[2275,2280,2284,2288,2293],{"type":26,"tag":113,"props":2276,"children":2277},{},[2278],{"type":31,"value":2279},"排查线上问题/性能抖动",{"type":26,"tag":113,"props":2281,"children":2282},{"align":2111},[2283],{"type":31,"value":2230},{"type":26,"tag":113,"props":2285,"children":2286},{"align":2111},[2287],{"type":31,"value":2257},{"type":26,"tag":113,"props":2289,"children":2290},{},[2291],{"type":31,"value":2292},"VS Code + 工具链优先，AI 辅助归纳",{"type":26,"tag":113,"props":2294,"children":2295},{},[2296],{"type":31,"value":2297},"需要证据，不要“猜”",{"type":26,"tag":27,"props":2299,"children":2300},{},[2301],{"type":26,"tag":862,"props":2302,"children":2303},{},[2304],{"type":31,"value":2305},"一句话规则：",{"type":26,"tag":395,"props":2307,"children":2308},{},[2309,2314],{"type":26,"tag":399,"props":2310,"children":2311},{},[2312],{"type":31,"value":2313},"当你的改动可以用“10 条最小回归集”覆盖时，用 Cursor。",{"type":26,"tag":399,"props":2315,"children":2316},{},[2317],{"type":31,"value":2318},"当你的改动无法验证时，先别让 AI 动手。",{"type":26,"tag":923,"props":2320,"children":2321},{},[],{"type":26,"tag":76,"props":2323,"children":2325},{"id":2324},"差异拆解到底差在哪里",[2326],{"type":31,"value":2327},"差异拆解：到底差在哪里？",{"type":26,"tag":1249,"props":2329,"children":2331},{"id":2330},"_1-上下文来源补全-vs-项目索引",[2332],{"type":31,"value":2333},"1) 上下文来源：补全 vs 项目索引",{"type":26,"tag":395,"props":2335,"children":2336},{},[2337,2342],{"type":26,"tag":399,"props":2338,"children":2339},{},[2340],{"type":31,"value":2341},"Copilot 更擅长：你正在写的这几行、当前文件的局部上下文",{"type":26,"tag":399,"props":2343,"children":2344},{},[2345],{"type":31,"value":2346},"Cursor 更擅长：项目级索引 + 多文件关联理解",{"type":26,"tag":27,"props":2348,"children":2349},{},[2350],{"type":31,"value":2351},"因此：",{"type":26,"tag":395,"props":2353,"children":2354},{},[2355,2360],{"type":26,"tag":399,"props":2356,"children":2357},{},[2358],{"type":31,"value":2359},"写代码片段：Copilot 速度更快",{"type":26,"tag":399,"props":2361,"children":2362},{},[2363],{"type":31,"value":2364},"改一坨工程：Cursor 更有胜算（但更需要闸门）",{"type":26,"tag":1249,"props":2366,"children":2368},{"id":2367},"_2-交互方式你能不能控制范围",[2369],{"type":31,"value":2370},"2) 交互方式：你能不能控制范围",{"type":26,"tag":27,"props":2372,"children":2373},{},[2374],{"type":31,"value":2375},"范围控制的三个层级：",{"type":26,"tag":431,"props":2377,"children":2378},{},[2379,2389,2399],{"type":26,"tag":399,"props":2380,"children":2381},{},[2382,2384],{"type":31,"value":2383},"内联编辑（选中一段）→ ",{"type":26,"tag":862,"props":2385,"children":2386},{},[2387],{"type":31,"value":2388},"最强范围控制",{"type":26,"tag":399,"props":2390,"children":2391},{},[2392,2394],{"type":31,"value":2393},"Composer 多文件（先列文件清单）→ ",{"type":26,"tag":862,"props":2395,"children":2396},{},[2397],{"type":31,"value":2398},"可控但要闸门",{"type":26,"tag":399,"props":2400,"children":2401},{},[2402,2404],{"type":31,"value":2403},"大对话（泛目标）→ ",{"type":26,"tag":862,"props":2405,"children":2406},{},[2407],{"type":31,"value":2408},"最容易跑偏",{"type":26,"tag":1249,"props":2410,"children":2412},{"id":2411},"_3-输出形态建议-vs-可审查的变更",[2413],{"type":31,"value":2414},"3) 输出形态：建议 vs 可审查的变更",{"type":26,"tag":27,"props":2416,"children":2417},{},[2418],{"type":31,"value":2419},"最好的 AI 输出不是“给我一段代码”，而是：",{"type":26,"tag":395,"props":2421,"children":2422},{},[2423,2428,2433],{"type":26,"tag":399,"props":2424,"children":2425},{},[2426],{"type":31,"value":2427},"改动摘要（做了什么）",{"type":26,"tag":399,"props":2429,"children":2430},{},[2431],{"type":31,"value":2432},"diff 级别的可审查变更",{"type":26,"tag":399,"props":2434,"children":2435},{},[2436],{"type":31,"value":2437},"验收步骤与回滚方案",{"type":26,"tag":923,"props":2439,"children":2440},{},[],{"type":26,"tag":76,"props":2442,"children":2444},{"id":2443},"一套可落地的团队工作流把风险关住",[2445],{"type":31,"value":2446},"一套可落地的团队工作流（把风险关住）",{"type":26,"tag":27,"props":2448,"children":2449},{},[2450],{"type":31,"value":2451},"下面这套流程，你可以直接写进团队规范：",{"type":26,"tag":1249,"props":2453,"children":2455},{"id":2454},"step-1先写任务单geo-友好结构",[2456],{"type":31,"value":2457},"Step 1：先写任务单（GEO 友好结构）",{"type":26,"tag":27,"props":2459,"children":2460},{},[2461],{"type":31,"value":2462},"模板：",{"type":26,"tag":395,"props":2464,"children":2465},{},[2466,2471,2476,2481,2486,2491],{"type":26,"tag":399,"props":2467,"children":2468},{},[2469],{"type":31,"value":2470},"目标：……",{"type":26,"tag":399,"props":2472,"children":2473},{},[2474],{"type":31,"value":2475},"背景：……",{"type":26,"tag":399,"props":2477,"children":2478},{},[2479],{"type":31,"value":2480},"范围：只改这些文件/模块：……",{"type":26,"tag":399,"props":2482,"children":2483},{},[2484],{"type":31,"value":2485},"非目标：不做哪些事情：……",{"type":26,"tag":399,"props":2487,"children":2488},{},[2489],{"type":31,"value":2490},"验收：如何判断完成（可测试/可观察）：……",{"type":26,"tag":399,"props":2492,"children":2493},{},[2494],{"type":31,"value":2495},"回滚：如果失败怎么撤回：……",{"type":26,"tag":1249,"props":2497,"children":2499},{"id":2498},"step-2用范围闸门限制-ai",[2500],{"type":31,"value":2501},"Step 2：用“范围闸门”限制 AI",{"type":26,"tag":395,"props":2503,"children":2504},{},[2505,2510],{"type":26,"tag":399,"props":2506,"children":2507},{},[2508],{"type":31,"value":2509},"单文件改动：优先 Cursor 内联编辑",{"type":26,"tag":399,"props":2511,"children":2512},{},[2513],{"type":31,"value":2514},"多文件改动：必须先让 AI 输出“文件清单（≤5）+ 每步验收”",{"type":26,"tag":27,"props":2516,"children":2517},{},[2518],{"type":31,"value":2519},"如果 AI 输出的文件清单超过 5 个：",{"type":26,"tag":395,"props":2521,"children":2522},{},[2523,2528],{"type":26,"tag":399,"props":2524,"children":2525},{},[2526],{"type":31,"value":2527},"不是它太强，是任务太大",{"type":26,"tag":399,"props":2529,"children":2530},{},[2531],{"type":31,"value":2532},"你需要拆任务，而不是继续推进",{"type":26,"tag":1249,"props":2534,"children":2536},{"id":2535},"step-3最小回归集10-条",[2537],{"type":31,"value":2538},"Step 3：最小回归集（10 条）",{"type":26,"tag":27,"props":2540,"children":2541},{},[2542,2544,2549],{"type":31,"value":2543},"每次接受改动前必须跑（可参考：",{"type":26,"tag":44,"props":2545,"children":2546},{"href":808},[2547],{"type":31,"value":2548},"Cursor 快捷键速查表",{"type":31,"value":2550}," 里的清单）。",{"type":26,"tag":1249,"props":2552,"children":2554},{"id":2553},"step-4回滚策略不用等事故才想",[2555],{"type":31,"value":2556},"Step 4：回滚策略（不用等事故才想）",{"type":26,"tag":27,"props":2558,"children":2559},{},[2560],{"type":31,"value":2561},"回滚最常见的两条路：",{"type":26,"tag":395,"props":2563,"children":2564},{},[2565,2570],{"type":26,"tag":399,"props":2566,"children":2567},{},[2568],{"type":31,"value":2569},"git 回滚 commit",{"type":26,"tag":399,"props":2571,"children":2572},{},[2573],{"type":31,"value":2574},"对关键文件保留前版本（至少能快速恢复）",{"type":26,"tag":27,"props":2576,"children":2577},{},[2578],{"type":31,"value":2579},"你需要做到：任何一轮 AI 改动都能在 5 分钟内撤回。",{"type":26,"tag":923,"props":2581,"children":2582},{},[],{"type":26,"tag":76,"props":2584,"children":2586},{"id":2585},"必交付物对比矩阵可复制",[2587],{"type":31,"value":2588},"必交付物：对比矩阵（可复制）",{"type":26,"tag":27,"props":2590,"children":2591},{},[2592],{"type":31,"value":2593},"下面这张表可以直接贴到你的团队 wiki：",{"type":26,"tag":83,"props":2595,"children":2596},{},[2597,2620],{"type":26,"tag":87,"props":2598,"children":2599},{},[2600],{"type":26,"tag":91,"props":2601,"children":2602},{},[2603,2608,2612,2616],{"type":26,"tag":95,"props":2604,"children":2605},{},[2606],{"type":31,"value":2607},"维度",{"type":26,"tag":95,"props":2609,"children":2610},{},[2611],{"type":31,"value":816},{"type":26,"tag":95,"props":2613,"children":2614},{},[2615],{"type":31,"value":2061},{"type":26,"tag":95,"props":2617,"children":2618},{},[2619],{"type":31,"value":813},{"type":26,"tag":106,"props":2621,"children":2622},{},[2623,2646,2669,2692],{"type":26,"tag":91,"props":2624,"children":2625},{},[2626,2631,2636,2641],{"type":26,"tag":113,"props":2627,"children":2628},{},[2629],{"type":31,"value":2630},"强项",{"type":26,"tag":113,"props":2632,"children":2633},{},[2634],{"type":31,"value":2635},"工具链、调试、生态",{"type":26,"tag":113,"props":2637,"children":2638},{},[2639],{"type":31,"value":2640},"补全与局部建议",{"type":26,"tag":113,"props":2642,"children":2643},{},[2644],{"type":31,"value":2645},"项目上下文、多文件落地",{"type":26,"tag":91,"props":2647,"children":2648},{},[2649,2654,2659,2664],{"type":26,"tag":113,"props":2650,"children":2651},{},[2652],{"type":31,"value":2653},"适合任务",{"type":26,"tag":113,"props":2655,"children":2656},{},[2657],{"type":31,"value":2658},"排查、调试、验证",{"type":26,"tag":113,"props":2660,"children":2661},{},[2662],{"type":31,"value":2663},"写一段、补一段",{"type":26,"tag":113,"props":2665,"children":2666},{},[2667],{"type":31,"value":2668},"改一段、改一组文件",{"type":26,"tag":91,"props":2670,"children":2671},{},[2672,2677,2682,2687],{"type":26,"tag":113,"props":2673,"children":2674},{},[2675],{"type":31,"value":2676},"最大风险",{"type":26,"tag":113,"props":2678,"children":2679},{},[2680],{"type":31,"value":2681},"无",{"type":26,"tag":113,"props":2683,"children":2684},{},[2685],{"type":31,"value":2686},"过度依赖建议",{"type":26,"tag":113,"props":2688,"children":2689},{},[2690],{"type":31,"value":2691},"范围漂移、多文件回归",{"type":26,"tag":91,"props":2693,"children":2694},{},[2695,2700,2705,2710],{"type":26,"tag":113,"props":2696,"children":2697},{},[2698],{"type":31,"value":2699},"必须搭配",{"type":26,"tag":113,"props":2701,"children":2702},{},[2703],{"type":31,"value":2704},"规范与检查",{"type":26,"tag":113,"props":2706,"children":2707},{},[2708],{"type":31,"value":2709},"代码评审",{"type":26,"tag":113,"props":2711,"children":2712},{},[2713],{"type":31,"value":2714},"闸门 + 最小回归集",{"type":26,"tag":923,"props":2716,"children":2717},{},[],{"type":26,"tag":76,"props":2719,"children":2721},{"id":2720},"失败案例多文件看似成功实际埋雷",[2722],{"type":31,"value":2723},"失败案例：多文件“看似成功”，实际埋雷",{"type":26,"tag":27,"props":2725,"children":2726},{},[2727,2732],{"type":26,"tag":862,"props":2728,"children":2729},{},[2730],{"type":31,"value":2731},"现象",{"type":31,"value":2733},"：AI 说“我已经把所有地方都改了”，你也接受了，结果上线后 404 或样式错位。",{"type":26,"tag":27,"props":2735,"children":2736},{},[2737,2742],{"type":26,"tag":862,"props":2738,"children":2739},{},[2740],{"type":31,"value":2741},"复现条件",{"type":31,"value":1555},{"type":26,"tag":395,"props":2744,"children":2745},{},[2746,2751,2756],{"type":26,"tag":399,"props":2747,"children":2748},{},[2749],{"type":31,"value":2750},"你给了一个大目标（例如“把所有按钮统一成主题色”）",{"type":26,"tag":399,"props":2752,"children":2753},{},[2754],{"type":31,"value":2755},"它改了组件、样式、甚至主题配置",{"type":26,"tag":399,"props":2757,"children":2758},{},[2759],{"type":31,"value":2760},"你没有按页面模块走一遍，直接合并",{"type":26,"tag":27,"props":2762,"children":2763},{},[2764,2769],{"type":26,"tag":862,"props":2765,"children":2766},{},[2767],{"type":31,"value":2768},"根因",{"type":31,"value":1555},{"type":26,"tag":395,"props":2771,"children":2772},{},[2773],{"type":26,"tag":399,"props":2774,"children":2775},{},[2776],{"type":31,"value":2777},"改动范围大，但验收仍按“小改动”的方式做（只看一处）",{"type":26,"tag":27,"props":2779,"children":2780},{},[2781,2786],{"type":26,"tag":862,"props":2782,"children":2783},{},[2784],{"type":31,"value":2785},"修复",{"type":31,"value":1555},{"type":26,"tag":395,"props":2788,"children":2789},{},[2790,2795,2800],{"type":26,"tag":399,"props":2791,"children":2792},{},[2793],{"type":31,"value":2794},"强制把任务拆成“模块级目标”：Hero、Feature、Pricing、Form",{"type":26,"tag":399,"props":2796,"children":2797},{},[2798],{"type":31,"value":2799},"每个模块改完就验收一次",{"type":26,"tag":399,"props":2801,"children":2802},{},[2803],{"type":31,"value":2804},"验收通过再进入下一个模块",{"type":26,"tag":923,"props":2806,"children":2807},{},[],{"type":26,"tag":76,"props":2809,"children":2811},{"id":2810},"faq",[2812],{"type":31,"value":2813},"FAQ",{"type":26,"tag":1249,"props":2815,"children":2817},{"id":2816},"q1我已经用了-cursor为什么还要用-copilot",[2818],{"type":31,"value":2819},"Q1：我已经用了 Cursor，为什么还要用 Copilot？",{"type":26,"tag":27,"props":2821,"children":2822},{},[2823],{"type":31,"value":2824},"因为“补全”这种高频低风险任务，Copilot 的交互成本更低；Cursor 更适合需要解释与约束的改动。",{"type":26,"tag":1249,"props":2826,"children":2828},{"id":2827},"q2什么时候应该完全不用-ai",[2829],{"type":31,"value":2830},"Q2：什么时候应该完全不用 AI？",{"type":26,"tag":27,"props":2832,"children":2833},{},[2834],{"type":31,"value":2835},"当你无法定义验收标准时。比如“更高级”“更好看”这种目标，先做信息结构与设计规则，再让 AI 帮你落地局部。",{"type":26,"tag":923,"props":2837,"children":2838},{},[],{"type":26,"tag":76,"props":2840,"children":2842},{"id":2841},"延伸阅读",[2843],{"type":31,"value":2841},{"type":26,"tag":395,"props":2845,"children":2846},{},[2847,2856,2865,2874],{"type":26,"tag":399,"props":2848,"children":2849},{},[2850,2852],{"type":31,"value":2851},"Cursor 入门：",{"type":26,"tag":44,"props":2853,"children":2854},{"href":896},[2855],{"type":31,"value":899},{"type":26,"tag":399,"props":2857,"children":2858},{},[2859,2861],{"type":31,"value":2860},"Cursor 进阶：",{"type":26,"tag":44,"props":2862,"children":2863},{"href":907},[2864],{"type":31,"value":910},{"type":26,"tag":399,"props":2866,"children":2867},{},[2868,2870],{"type":31,"value":2869},"规则配置：",{"type":26,"tag":44,"props":2871,"children":2872},{"href":918},[2873],{"type":31,"value":921},{"type":26,"tag":399,"props":2875,"children":2876},{},[2877,2879],{"type":31,"value":2878},"Copilot 实战：",{"type":26,"tag":44,"props":2880,"children":2882},{"href":2881},"/topics/ai/github-copilot-tips",[2883],{"type":31,"value":2884},"GitHub Copilot 实用技巧",{"title":7,"searchDepth":787,"depth":787,"links":2886},[2887,2888,2889,2894,2900,2901,2902,2906],{"id":2033,"depth":790,"text":2036},{"id":2083,"depth":790,"text":2086},{"id":2324,"depth":790,"text":2327,"children":2890},[2891,2892,2893],{"id":2330,"depth":787,"text":2333},{"id":2367,"depth":787,"text":2370},{"id":2411,"depth":787,"text":2414},{"id":2443,"depth":790,"text":2446,"children":2895},[2896,2897,2898,2899],{"id":2454,"depth":787,"text":2457},{"id":2498,"depth":787,"text":2501},{"id":2535,"depth":787,"text":2538},{"id":2553,"depth":787,"text":2556},{"id":2585,"depth":790,"text":2588},{"id":2720,"depth":790,"text":2723},{"id":2810,"depth":790,"text":2813,"children":2903},[2904,2905],{"id":2816,"depth":787,"text":2819},{"id":2827,"depth":787,"text":2830},{"id":2841,"depth":790,"text":2841},"content:topics:ai:cursor-vs-copilot-vscode-workflow.md","topics/ai/cursor-vs-copilot-vscode-workflow.md","topics/ai/cursor-vs-copilot-vscode-workflow",{"_path":2911,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":2912,"description":2913,"date":2914,"topic":5,"author":11,"tags":2915,"image":2920,"featured":663,"readingTime":1974,"body":2921,"_type":800,"_id":3569,"_source":802,"_file":3570,"_stem":3571,"_extension":805},"/topics/ai/ai-debugging-troubleshooting-guide","AI 辅助调试与问题排查：让 AI 成为你的调试搭档","深入探讨如何利用 AI 工具提升调试效率，包括错误信息分析、日志解读、性能问题定位、复杂 bug 排查等实战场景，构建 AI 驱动的调试工作流。","2026-01-18",[2916,2917,2918,817,2919],"AI 调试","问题排查","Debug","错误处理","/images/topics/ai/ai-debugging-guide.jpg",{"type":23,"children":2922,"toc":3540},[2923,2929,2935,2940,2945,2950,2956,2962,2967,2975,3003,3011,3034,3040,3050,3059,3067,3075,3108,3116,3146,3159,3167,3172,3180,3188,3199,3205,3213,3224,3232,3241,3247,3253,3258,3267,3273,3278,3287,3293,3299,3308,3314,3323,3329,3340,3346,3352,3361,3367,3376,3382,3388,3396,3402,3411,3419,3427,3430,3436,3441,3460,3472,3475,3481,3486,3495,3500,3503,3509,3514,3532],{"type":26,"tag":76,"props":2924,"children":2926},{"id":2925},"ai-辅助调试与问题排查",[2927],{"type":31,"value":2928},"AI 辅助调试与问题排查",{"type":26,"tag":76,"props":2930,"children":2932},{"id":2931},"引言调试的痛与-ai-的解药",[2933],{"type":31,"value":2934},"引言：调试的痛与 AI 的解药",{"type":26,"tag":27,"props":2936,"children":2937},{},[2938],{"type":31,"value":2939},"调试是每个程序员的日常，也是最消耗时间和精力的工作之一。我们都有过这样的经历：盯着一个莫名其妙的错误信息，翻遍 Stack Overflow，尝试各种方案，几个小时后才发现是一个愚蠢的拼写错误。",{"type":26,"tag":27,"props":2941,"children":2942},{},[2943],{"type":31,"value":2944},"AI 工具的出现，正在改变调试的方式。不是替代你的思考，而是加速你的分析过程——帮你快速理解错误、缩小排查范围、验证假设。",{"type":26,"tag":27,"props":2946,"children":2947},{},[2948],{"type":31,"value":2949},"这篇文章分享我在实际项目中使用 AI 辅助调试的经验和方法论。",{"type":26,"tag":76,"props":2951,"children":2953},{"id":2952},"第一部分建立-ai-调试的思维模型",[2954],{"type":31,"value":2955},"第一部分：建立 AI 调试的思维模型",{"type":26,"tag":1249,"props":2957,"children":2959},{"id":2958},"_11-ai-在调试中的角色",[2960],{"type":31,"value":2961},"1.1 AI 在调试中的角色",{"type":26,"tag":27,"props":2963,"children":2964},{},[2965],{"type":31,"value":2966},"把 AI 想象成一个经验丰富但不了解你项目的高级工程师。它：",{"type":26,"tag":27,"props":2968,"children":2969},{},[2970],{"type":26,"tag":862,"props":2971,"children":2972},{},[2973],{"type":31,"value":2974},"擅长的事情：",{"type":26,"tag":395,"props":2976,"children":2977},{},[2978,2983,2988,2993,2998],{"type":26,"tag":399,"props":2979,"children":2980},{},[2981],{"type":31,"value":2982},"解读错误信息的含义",{"type":26,"tag":399,"props":2984,"children":2985},{},[2986],{"type":31,"value":2987},"提供可能的原因列表",{"type":26,"tag":399,"props":2989,"children":2990},{},[2991],{"type":31,"value":2992},"给出排查方向建议",{"type":26,"tag":399,"props":2994,"children":2995},{},[2996],{"type":31,"value":2997},"解释复杂的技术概念",{"type":26,"tag":399,"props":2999,"children":3000},{},[3001],{"type":31,"value":3002},"生成调试代码片段",{"type":26,"tag":27,"props":3004,"children":3005},{},[3006],{"type":26,"tag":862,"props":3007,"children":3008},{},[3009],{"type":31,"value":3010},"不擅长的事情：",{"type":26,"tag":395,"props":3012,"children":3013},{},[3014,3019,3024,3029],{"type":26,"tag":399,"props":3015,"children":3016},{},[3017],{"type":31,"value":3018},"了解你的业务逻辑",{"type":26,"tag":399,"props":3020,"children":3021},{},[3022],{"type":31,"value":3023},"知道你的代码历史",{"type":26,"tag":399,"props":3025,"children":3026},{},[3027],{"type":31,"value":3028},"理解项目特定的约定",{"type":26,"tag":399,"props":3030,"children":3031},{},[3032],{"type":31,"value":3033},"做出架构级判断",{"type":26,"tag":1249,"props":3035,"children":3037},{"id":3036},"_12-有效提问的结构",[3038],{"type":31,"value":3039},"1.2 有效提问的结构",{"type":26,"tag":258,"props":3041,"children":3045},{"code":3042,"language":800,"meta":7,"className":3043},"## 高效的调试提问模板\n\n**问题描述**\n[简洁描述遇到的问题]\n\n**错误信息**\n",[3044],"language-markdown",[3046],{"type":26,"tag":214,"props":3047,"children":3048},{"__ignoreMap":7},[3049],{"type":31,"value":3042},{"type":26,"tag":27,"props":3051,"children":3052},{},[3053],{"type":26,"tag":3054,"props":3055,"children":3056},"span",{},[3057],{"type":31,"value":3058},"完整的错误信息，不要截断",{"type":26,"tag":258,"props":3060,"children":3062},{"code":3061},"\n**相关代码**\n```javascript\n[精简但完整的相关代码]\n",[3063],{"type":26,"tag":214,"props":3064,"children":3065},{"__ignoreMap":7},[3066],{"type":31,"value":3061},{"type":26,"tag":27,"props":3068,"children":3069},{},[3070],{"type":26,"tag":862,"props":3071,"children":3072},{},[3073],{"type":31,"value":3074},"环境信息",{"type":26,"tag":395,"props":3076,"children":3077},{},[3078,3088,3098],{"type":26,"tag":399,"props":3079,"children":3080},{},[3081,3083],{"type":31,"value":3082},"运行环境：",{"type":26,"tag":3054,"props":3084,"children":3085},{},[3086],{"type":31,"value":3087},"Node 版本/浏览器版本",{"type":26,"tag":399,"props":3089,"children":3090},{},[3091,3093],{"type":31,"value":3092},"框架版本：",{"type":26,"tag":3054,"props":3094,"children":3095},{},[3096],{"type":31,"value":3097},"相关框架版本",{"type":26,"tag":399,"props":3099,"children":3100},{},[3101,3103],{"type":31,"value":3102},"操作系统：",{"type":26,"tag":3054,"props":3104,"children":3105},{},[3106],{"type":31,"value":3107},"如果相关",{"type":26,"tag":27,"props":3109,"children":3110},{},[3111],{"type":26,"tag":862,"props":3112,"children":3113},{},[3114],{"type":31,"value":3115},"已尝试的方案",{"type":26,"tag":395,"props":3117,"children":3118},{},[3119,3133],{"type":26,"tag":399,"props":3120,"children":3121},{},[3122,3127,3128],{"type":26,"tag":3054,"props":3123,"children":3124},{},[3125],{"type":31,"value":3126},"方案1",{"type":31,"value":1555},{"type":26,"tag":3054,"props":3129,"children":3130},{},[3131],{"type":31,"value":3132},"结果",{"type":26,"tag":399,"props":3134,"children":3135},{},[3136,3141,3142],{"type":26,"tag":3054,"props":3137,"children":3138},{},[3139],{"type":31,"value":3140},"方案2",{"type":31,"value":1555},{"type":26,"tag":3054,"props":3143,"children":3144},{},[3145],{"type":31,"value":3132},{"type":26,"tag":27,"props":3147,"children":3148},{},[3149,3154],{"type":26,"tag":862,"props":3150,"children":3151},{},[3152],{"type":31,"value":3153},"期望的结果",{"type":26,"tag":3054,"props":3155,"children":3156},{},[3157],{"type":31,"value":3158},"描述期望的行为",{"type":26,"tag":258,"props":3160,"children":3162},{"code":3161},"\n### 1.3 分级调试策略\n\n",[3163],{"type":26,"tag":214,"props":3164,"children":3165},{"__ignoreMap":7},[3166],{"type":31,"value":3161},{"type":26,"tag":27,"props":3168,"children":3169},{},[3170],{"type":31,"value":3171},"┌───────────────────────────────────────────────────────────┐\n│ AI 辅助调试决策树 │\n├───────────────────────────────────────────────────────────┤\n│ │\n│ Level 1：简单错误（5分钟内解决） │\n│ ├── 语法错误、拼写错误 │\n│ ├── 方法：直接复制错误信息给 AI │\n│ └── 工具：Copilot Chat / ChatGPT │\n│ │\n│ Level 2：中等复杂度（30分钟内解决） │\n│ ├── 类型错误、逻辑错误、API 使用错误 │\n│ ├── 方法：提供错误信息 + 相关代码 + 上下文 │\n│ └── 工具：Cursor Chat / Claude │\n│ │\n│ Level 3：复杂问题（需要深入分析） │\n│ ├── 竞态条件、内存泄漏、性能问题 │\n│ ├── 方法：详细描述场景 + 提供多个文件 + 讨论 │\n│ └── 工具：Cursor Composer / 专门的 AI 会话 │\n│ │\n│ Level 4：架构级问题 │\n│ ├── 设计缺陷、技术债务 │\n│ ├── 方法：AI 辅助分析 + 人工判断 │\n│ └── 工具：与团队讨论 + AI 作为顾问 │\n│ │\n└───────────────────────────────────────────────────────────┘",{"type":26,"tag":258,"props":3173,"children":3175},{"code":3174},"\n## 第二部分：错误信息分析\n\n### 2.1 前端错误分析\n\n**场景 1：React 错误边界触发**\n\n```typescript\n// 错误信息：\n// Error: Hydration failed because the initial UI does not match \n// what was rendered on the server.\n\n// 提问方式：\n/**\n * 我在 Next.js 14 App Router 项目中遇到这个错误：\n * \n * Error: Hydration failed because the initial UI does not match \n * what was rendered on the server.\n * \n * 相关代码：\n */\nfunction UserStatus() {\n const [isLoggedIn, setIsLoggedIn] = useState(false);\n \n useEffect(() => {\n setIsLoggedIn(localStorage.getItem('token') !== null);\n }, []);\n \n return \u003Cdiv>{isLoggedIn ? '已登录' : '未登录'}\u003C/div>;\n}\n\n// AI 会分析出：\n// 1. 服务端渲染时 localStorage 不可用，默认 false\n// 2. 客户端 hydration 时可能是 true\n// 3. 导致服务端和客户端渲染结果不一致\n\n// AI 建议的解决方案：\nfunction UserStatus() {\n const [isLoggedIn, setIsLoggedIn] = useState\u003Cboolean | null>(null);\n \n useEffect(() => {\n setIsLoggedIn(localStorage.getItem('token') !== null);\n }, []);\n \n // 初始状态显示加载中，避免 hydration 不匹配\n if (isLoggedIn === null) {\n return \u003Cdiv>加载中...\u003C/div>;\n }\n \n return \u003Cdiv>{isLoggedIn ? '已登录' : '未登录'}\u003C/div>;\n}\n",[3176],{"type":26,"tag":214,"props":3177,"children":3178},{"__ignoreMap":7},[3179],{"type":31,"value":3174},{"type":26,"tag":27,"props":3181,"children":3182},{},[3183],{"type":26,"tag":862,"props":3184,"children":3185},{},[3186],{"type":31,"value":3187},"场景 2：Vue 响应式警告",{"type":26,"tag":258,"props":3189,"children":3194},{"code":3190,"language":3191,"meta":7,"className":3192},"// 警告信息：\n// [Vue warn]: Property \"xxx\" was accessed during render but is not \n// defined on instance.\n\n// 提问方式：\n/**\n * Vue 3 项目中出现这个警告：\n * [Vue warn]: Property \"userInfo\" was accessed during render \n * but is not defined on instance.\n * \n * 组件代码：\n */\n\u003Ctemplate>\n \u003Cdiv>{{ userInfo.name }}\u003C/div>\n\u003C/template>\n\n\u003Cscript setup>\nconst { data: userInfo } = await useFetch('/api/user');\n\u003C/script>\n\n// AI 分析：\n// 1. useFetch 是异步的，初始渲染时 userInfo 可能是 undefined\n// 2. 直接访问 userInfo.name 会报错\n\n// AI 建议：\n\u003Ctemplate>\n \u003Cdiv v-if=\"userInfo\">{{ userInfo.name }}\u003C/div>\n \u003Cdiv v-else>加载中...\u003C/div>\n\u003C/template>\n\n\u003Cscript setup>\nconst { data: userInfo, pending } = await useFetch('/api/user');\n\u003C/script>\n","typescript",[3193],"language-typescript",[3195],{"type":26,"tag":214,"props":3196,"children":3197},{"__ignoreMap":7},[3198],{"type":31,"value":3190},{"type":26,"tag":1249,"props":3200,"children":3202},{"id":3201},"_22-后端错误分析",[3203],{"type":31,"value":3204},"2.2 后端错误分析",{"type":26,"tag":27,"props":3206,"children":3207},{},[3208],{"type":26,"tag":862,"props":3209,"children":3210},{},[3211],{"type":31,"value":3212},"场景 1：Node.js 内存问题",{"type":26,"tag":258,"props":3214,"children":3219},{"code":3215,"language":3216,"meta":7,"className":3217},"// 错误信息：\n// FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - \n// JavaScript heap out of memory\n\n// 提问方式（包含上下文）：\n/**\n * Node.js 服务运行几小时后崩溃，错误信息：\n * FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - \n * JavaScript heap out of memory\n * \n * 服务功能：处理 CSV 文件上传，每次约 100MB\n * \n * 处理代码：\n */\nasync function processCSV(filePath) {\n const content = fs.readFileSync(filePath, 'utf-8');\n const rows = content.split('\\n');\n const results = [];\n \n for (const row of rows) {\n const processed = await processRow(row);\n results.push(processed);\n }\n \n return results;\n}\n\n// AI 分析会指出：\n// 1. 一次性读取整个文件到内存\n// 2. 所有处理结果累积在 results 数组\n// 3. 建议使用流式处理\n\n// AI 提供的优化方案：\nconst { createReadStream } = require('fs');\nconst { createInterface } = require('readline');\n\nasync function processCSVStream(filePath, onRow) {\n const fileStream = createReadStream(filePath);\n const rl = createInterface({\n input: fileStream,\n crlfDelay: Infinity\n });\n \n let count = 0;\n for await (const line of rl) {\n await onRow(line);\n count++;\n \n // 每处理 1000 行，给 GC 机会运行\n if (count % 1000 === 0) {\n await new Promise(r => setImmediate(r));\n }\n }\n}\n","javascript",[3218],"language-javascript",[3220],{"type":26,"tag":214,"props":3221,"children":3222},{"__ignoreMap":7},[3223],{"type":31,"value":3215},{"type":26,"tag":27,"props":3225,"children":3226},{},[3227],{"type":26,"tag":862,"props":3228,"children":3229},{},[3230],{"type":31,"value":3231},"场景 2：数据库连接问题",{"type":26,"tag":258,"props":3233,"children":3236},{"code":3234,"language":3191,"meta":7,"className":3235},"// 错误信息：\n// Error: Connection pool exhausted - \n// max connections (10) already in use\n\n// 提问方式：\n/**\n * PostgreSQL 连接池耗尽错误，高并发时出现：\n * Error: Connection pool exhausted\n * \n * 当前配置：\n * - max connections: 10\n * - 并发请求: 约 100/秒\n * \n * 数据库调用代码：\n */\nasync function getUserData(userId: string) {\n const client = await pool.connect();\n try {\n const user = await client.query('SELECT * FROM users WHERE id = $1', [userId]);\n const orders = await client.query('SELECT * FROM orders WHERE user_id = $1', [userId]);\n const payments = await client.query('SELECT * FROM payments WHERE user_id = $1', [userId]);\n return { user: user.rows[0], orders: orders.rows, payments: payments.rows };\n } finally {\n client.release();\n }\n}\n\n// AI 会分析出多个可能原因并给出综合方案\n",[3193],[3237],{"type":26,"tag":214,"props":3238,"children":3239},{"__ignoreMap":7},[3240],{"type":31,"value":3234},{"type":26,"tag":76,"props":3242,"children":3244},{"id":3243},"第三部分日志分析与问题定位",[3245],{"type":31,"value":3246},"第三部分：日志分析与问题定位",{"type":26,"tag":1249,"props":3248,"children":3250},{"id":3249},"_31-结构化日志分析",[3251],{"type":31,"value":3252},"3.1 结构化日志分析",{"type":26,"tag":27,"props":3254,"children":3255},{},[3256],{"type":31,"value":3257},"当面对大量日志时，让 AI 帮你快速定位问题：",{"type":26,"tag":258,"props":3259,"children":3262},{"code":3260,"language":3216,"meta":7,"className":3261},"// 提问示例：\n/**\n * 分析以下日志，找出导致请求失败的原因：\n * \n * 日志片段：\n */\nconst logs = `\n2024-01-15 10:23:45.123 INFO [req-abc123] 收到请求 POST /api/order\n2024-01-15 10:23:45.125 DEBUG [req-abc123] 用户认证通过 userId=u001\n2024-01-15 10:23:45.130 DEBUG [req-abc123] 开始库存检查 productId=p001\n2024-01-15 10:23:45.145 DEBUG [req-abc123] 库存检查通过 available=50\n2024-01-15 10:23:45.150 DEBUG [req-abc123] 开始创建订单\n2024-01-15 10:23:45.200 DEBUG [req-abc123] 数据库连接获取成功\n2024-01-15 10:23:45.250 ERROR [req-abc123] 订单创建失败 error=\"deadlock detected\"\n2024-01-15 10:23:45.251 WARN [req-abc123] 事务回滚\n2024-01-15 10:23:45.255 INFO [req-abc123] 响应 500 耗时 132ms\n`;\n\n// AI 分析结果会包括：\n// 1. 问题定位：数据库死锁\n// 2. 可能原因：并发订单创建导致锁竞争\n// 3. 排查建议：检查事务隔离级别、锁顺序\n",[3218],[3263],{"type":26,"tag":214,"props":3264,"children":3265},{"__ignoreMap":7},[3266],{"type":31,"value":3260},{"type":26,"tag":1249,"props":3268,"children":3270},{"id":3269},"_32-创建调试日志",[3271],{"type":31,"value":3272},"3.2 创建调试日志",{"type":26,"tag":27,"props":3274,"children":3275},{},[3276],{"type":31,"value":3277},"让 AI 帮你生成调试用的日志代码：",{"type":26,"tag":258,"props":3279,"children":3282},{"code":3280,"language":3191,"meta":7,"className":3281},"// 请求：\n// \"为这个函数添加详细的调试日志，包括入参、关键步骤、耗时和结果\"\n\n// 原代码：\nasync function processOrder(order: Order): Promise\u003COrderResult> {\n const inventory = await checkInventory(order.items);\n const payment = await processPayment(order.userId, order.total);\n const result = await createOrder(order, payment.transactionId);\n return result;\n}\n\n// AI 生成的带日志版本：\nasync function processOrder(order: Order): Promise\u003COrderResult> {\n const requestId = generateRequestId();\n const startTime = performance.now();\n \n logger.info({\n requestId,\n event: 'order_processing_start',\n orderId: order.id,\n userId: order.userId,\n itemCount: order.items.length,\n total: order.total\n });\n \n try {\n // 库存检查\n const inventoryStart = performance.now();\n const inventory = await checkInventory(order.items);\n logger.debug({\n requestId,\n event: 'inventory_check_complete',\n duration: performance.now() - inventoryStart,\n available: inventory.allAvailable\n });\n \n // 支付处理\n const paymentStart = performance.now();\n const payment = await processPayment(order.userId, order.total);\n logger.debug({\n requestId,\n event: 'payment_complete',\n duration: performance.now() - paymentStart,\n transactionId: payment.transactionId\n });\n \n // 创建订单\n const createStart = performance.now();\n const result = await createOrder(order, payment.transactionId);\n logger.debug({\n requestId,\n event: 'order_created',\n duration: performance.now() - createStart,\n resultOrderId: result.orderId\n });\n \n logger.info({\n requestId,\n event: 'order_processing_complete',\n duration: performance.now() - startTime,\n success: true\n });\n \n return result;\n } catch (error) {\n logger.error({\n requestId,\n event: 'order_processing_failed',\n duration: performance.now() - startTime,\n error: error.message,\n stack: error.stack\n });\n throw error;\n }\n}\n",[3193],[3283],{"type":26,"tag":214,"props":3284,"children":3285},{"__ignoreMap":7},[3286],{"type":31,"value":3280},{"type":26,"tag":76,"props":3288,"children":3290},{"id":3289},"第四部分性能问题排查",[3291],{"type":31,"value":3292},"第四部分：性能问题排查",{"type":26,"tag":1249,"props":3294,"children":3296},{"id":3295},"_41-前端性能分析",[3297],{"type":31,"value":3298},"4.1 前端性能分析",{"type":26,"tag":258,"props":3300,"children":3303},{"code":3301,"language":3191,"meta":7,"className":3302},"// 场景：页面加载慢，需要分析原因\n\n// 提问方式：\n/**\n * 页面首屏加载需要 5 秒，以下是 Performance API 数据，\n * 请分析性能瓶颈：\n */\nconst performanceData = {\n // Navigation Timing\n dns: 50, // DNS 查询\n tcp: 100, // TCP 连接\n ttfb: 800, // 首字节时间\n download: 200, // 文档下载\n domParsing: 300, // DOM 解析\n domContentLoaded: 1500,\n load: 5000,\n \n // Resource Timing (主要资源)\n resources: [\n { name: 'main.js', size: '2.5MB', duration: 1200 },\n { name: 'vendor.js', size: '1.8MB', duration: 900 },\n { name: 'styles.css', size: '500KB', duration: 300 },\n { name: 'hero-image.jpg', size: '3MB', duration: 1500 },\n ],\n \n // Long Tasks\n longTasks: [\n { startTime: 1600, duration: 800, name: 'script-evaluation' },\n { startTime: 2500, duration: 400, name: 'layout' }\n ]\n};\n\n// AI 会分析出：\n// 1. JS bundle 过大（4.3MB），需要代码分割\n// 2. 图片未优化（3MB 的 hero 图片）\n// 3. 存在长任务阻塞主线程\n// 并给出具体优化建议\n",[3193],[3304],{"type":26,"tag":214,"props":3305,"children":3306},{"__ignoreMap":7},[3307],{"type":31,"value":3301},{"type":26,"tag":1249,"props":3309,"children":3311},{"id":3310},"_42-内存泄漏排查",[3312],{"type":31,"value":3313},"4.2 内存泄漏排查",{"type":26,"tag":258,"props":3315,"children":3318},{"code":3316,"language":3191,"meta":7,"className":3317},"// 场景：应用运行一段时间后变卡\n\n// 提问方式：\n/**\n * React 应用运行一段时间后内存持续增长，以下是 Heap Snapshot 对比：\n * \n * 初始状态：50MB\n * 运行 1 小时后：150MB\n * 运行 2 小时后：280MB\n * \n * Retained objects 增长最快的：\n * - (closure) - 增长 50MB\n * - HTMLDivElement - 增长 30MB\n * - Array - 增长 20MB\n * \n * 可疑代码：\n */\nfunction DataDashboard() {\n const [data, setData] = useState([]);\n const chartRef = useRef(null);\n \n useEffect(() => {\n // 每秒刷新数据\n const interval = setInterval(async () => {\n const newData = await fetchLatestData();\n setData(prev => [...prev, ...newData]); // 数据不断累积\n }, 1000);\n \n // 初始化图表\n const chart = new Chart(chartRef.current, {\n // 配置...\n });\n \n // 没有 cleanup！\n }, []);\n \n return \u003Ccanvas ref={chartRef} />;\n}\n\n// AI 会指出：\n// 1. interval 没有清理\n// 2. Chart 实例没有销毁\n// 3. data 无限增长\n// 并提供修复代码\n",[3193],[3319],{"type":26,"tag":214,"props":3320,"children":3321},{"__ignoreMap":7},[3322],{"type":31,"value":3316},{"type":26,"tag":1249,"props":3324,"children":3326},{"id":3325},"_43-数据库查询优化",[3327],{"type":31,"value":3328},"4.3 数据库查询优化",{"type":26,"tag":258,"props":3330,"children":3335},{"code":3331,"language":3332,"meta":7,"className":3333},"-- 场景：查询很慢，让 AI 分析执行计划\n\n-- 提问方式：\n-- 以下查询在数据量大时很慢（orders 表 1000 万行），\n-- 执行计划如下，请分析并优化：\n\nEXPLAIN ANALYZE\nSELECT o.*, u.name, u.email\nFROM orders o\nJOIN users u ON o.user_id = u.id\nWHERE o.status = 'pending'\n AND o.created_at > '2024-01-01'\nORDER BY o.created_at DESC\nLIMIT 20;\n\n-- 执行计划：\n/*\nSort (cost=156847.23..157847.23 rows=400000 width=250)\n Sort Key: o.created_at DESC\n -> Hash Join (cost=1500.00..89847.23 rows=400000 width=250)\n Hash Cond: (o.user_id = u.id)\n -> Seq Scan on orders o (cost=0.00..85000.00 rows=400000)\n Filter: ((status = 'pending') AND (created_at > '2024-01-01'))\n -> Hash (cost=1000.00..1000.00 rows=50000 width=100)\n -> Seq Scan on users u (cost=0.00..1000.00 rows=50000)\nPlanning Time: 0.5 ms\nExecution Time: 3500 ms\n*/\n\n-- AI 会分析出问题并建议：\n-- 1. orders 表全表扫描 - 需要复合索引\n-- 2. 建议创建索引：\nCREATE INDEX idx_orders_status_created ON orders(status, created_at DESC);\n\n-- 3. 如果 status 选择性不高，考虑部分索引：\nCREATE INDEX idx_orders_pending ON orders(created_at DESC) \nWHERE status = 'pending';\n","sql",[3334],"language-sql",[3336],{"type":26,"tag":214,"props":3337,"children":3338},{"__ignoreMap":7},[3339],{"type":31,"value":3331},{"type":26,"tag":76,"props":3341,"children":3343},{"id":3342},"第五部分复杂-bug-排查",[3344],{"type":31,"value":3345},"第五部分：复杂 Bug 排查",{"type":26,"tag":1249,"props":3347,"children":3349},{"id":3348},"_51-竞态条件",[3350],{"type":31,"value":3351},"5.1 竞态条件",{"type":26,"tag":258,"props":3353,"children":3356},{"code":3354,"language":3191,"meta":7,"className":3355},"// 场景：偶发的数据不一致问题\n\n// 提问方式：\n/**\n * 用户反馈偶尔看到错误的账户余额，但刷新后正常。\n * 怀疑是竞态条件，以下是相关代码：\n */\nasync function updateBalance(userId: string, amount: number) {\n // 读取当前余额\n const user = await db.users.findOne({ id: userId });\n const newBalance = user.balance + amount;\n \n // 更新余额\n await db.users.update({ id: userId }, { balance: newBalance });\n \n // 记录交易\n await db.transactions.create({\n userId,\n amount,\n balanceAfter: newBalance,\n createdAt: new Date()\n });\n \n return newBalance;\n}\n\n// 并发调用场景：\n// 用户同时发起两笔交易：+100 和 -50\n// 期望结果：原余额 1000 → 1050\n// 实际可能：原余额 1000 → 1100 或 950\n\n// AI 会分析竞态条件并提供解决方案：\nasync function updateBalanceAtomic(userId: string, amount: number) {\n // 方案 1：使用数据库原子操作\n const result = await db.users.findOneAndUpdate(\n { id: userId },\n { $inc: { balance: amount } },\n { returnDocument: 'after' }\n );\n \n await db.transactions.create({\n userId,\n amount,\n balanceAfter: result.balance,\n createdAt: new Date()\n });\n \n return result.balance;\n}\n\n// 方案 2：使用乐观锁\nasync function updateBalanceOptimistic(userId: string, amount: number) {\n const maxRetries = 3;\n \n for (let i = 0; i \u003C maxRetries; i++) {\n const user = await db.users.findOne({ id: userId });\n const newBalance = user.balance + amount;\n \n const updated = await db.users.updateOne(\n { id: userId, version: user.version },\n { balance: newBalance, version: user.version + 1 }\n );\n \n if (updated.modifiedCount === 1) {\n await db.transactions.create({...});\n return newBalance;\n }\n \n // 版本冲突，重试\n await sleep(10 * (i + 1));\n }\n \n throw new Error('Update failed after retries');\n}\n",[3193],[3357],{"type":26,"tag":214,"props":3358,"children":3359},{"__ignoreMap":7},[3360],{"type":31,"value":3354},{"type":26,"tag":1249,"props":3362,"children":3364},{"id":3363},"_52-分布式系统问题",[3365],{"type":31,"value":3366},"5.2 分布式系统问题",{"type":26,"tag":258,"props":3368,"children":3371},{"code":3369,"language":3191,"meta":7,"className":3370},"// 场景：微服务间的数据不一致\n\n// 提问方式：\n/**\n * 订单服务和库存服务偶尔出现数据不一致：\n * - 订单显示已创建\n * - 库存未扣减\n * \n * 当前流程：\n */\n// Order Service\nasync function createOrder(orderData) {\n // 1. 调用库存服务扣减库存\n await inventoryService.deduct(orderData.items);\n \n // 2. 创建订单\n const order = await orderRepository.create(orderData);\n \n // 3. 发送订单创建事件\n await eventBus.publish('order.created', order);\n \n return order;\n}\n\n// 问题分析：如果步骤 2 或 3 失败，库存已经扣减但订单未创建\n\n// AI 会建议使用 Saga 模式或事务发件箱模式\n",[3193],[3372],{"type":26,"tag":214,"props":3373,"children":3374},{"__ignoreMap":7},[3375],{"type":31,"value":3369},{"type":26,"tag":76,"props":3377,"children":3379},{"id":3378},"第六部分ai-调试工作流",[3380],{"type":31,"value":3381},"第六部分：AI 调试工作流",{"type":26,"tag":1249,"props":3383,"children":3385},{"id":3384},"_61-我的调试流程",[3386],{"type":31,"value":3387},"6.1 我的调试流程",{"type":26,"tag":258,"props":3389,"children":3391},{"code":3390},"┌────────────────────────────────────────────────────────────┐\n│ AI 辅助调试工作流 │\n├────────────────────────────────────────────────────────────┤\n│ │\n│ Step 1: 问题收集 │\n│ ├── 复制完整错误信息 │\n│ ├── 截图相关日志 │\n│ └── 记录复现步骤 │\n│ │\n│ Step 2: 快速分析 │\n│ ├── 将错误信息发给 AI │\n│ ├── 获取可能原因列表 │\n│ └── 评估哪些最可能 │\n│ │\n│ Step 3: 深入调查 │\n│ ├── 根据 AI 建议添加日志/断点 │\n│ ├── 收集更多信息 │\n│ └── 再次询问 AI（带新信息） │\n│ │\n│ Step 4: 验证修复 │\n│ ├── AI 生成修复代码 │\n│ ├── 人工审查确认 │\n│ └── 测试验证 │\n│ │\n│ Step 5: 预防措施 │\n│ ├── AI 建议类似问题的预防方法 │\n│ ├── 添加相关测试用例 │\n│ └── 更新文档/知识库 │\n│ │\n└────────────────────────────────────────────────────────────┘\n",[3392],{"type":26,"tag":214,"props":3393,"children":3394},{"__ignoreMap":7},[3395],{"type":31,"value":3390},{"type":26,"tag":1249,"props":3397,"children":3399},{"id":3398},"_62-调试对话模板",[3400],{"type":31,"value":3401},"6.2 调试对话模板",{"type":26,"tag":258,"props":3403,"children":3406},{"code":3404,"language":800,"meta":7,"className":3405},"## 第一轮：问题描述\n\n我遇到了一个问题：[简述问题]\n\n错误信息：\n",[3044],[3407],{"type":26,"tag":214,"props":3408,"children":3409},{"__ignoreMap":7},[3410],{"type":31,"value":3404},{"type":26,"tag":27,"props":3412,"children":3413},{},[3414],{"type":26,"tag":3054,"props":3415,"children":3416},{},[3417],{"type":31,"value":3418},"粘贴完整错误",{"type":26,"tag":258,"props":3420,"children":3422},{"code":3421},"\n相关代码：\n```javascript\n[粘贴代码]\n",[3423],{"type":26,"tag":214,"props":3424,"children":3425},{"__ignoreMap":7},[3426],{"type":31,"value":3421},{"type":26,"tag":923,"props":3428,"children":3429},{},[],{"type":26,"tag":76,"props":3431,"children":3433},{"id":3432},"第二轮补充信息",[3434],{"type":31,"value":3435},"第二轮：补充信息",{"type":26,"tag":27,"props":3437,"children":3438},{},[3439],{"type":31,"value":3440},"根据你的建议，我添加了日志，发现：",{"type":26,"tag":395,"props":3442,"children":3443},{},[3444,3452],{"type":26,"tag":399,"props":3445,"children":3446},{},[3447],{"type":26,"tag":3054,"props":3448,"children":3449},{},[3450],{"type":31,"value":3451},"发现 1",{"type":26,"tag":399,"props":3453,"children":3454},{},[3455],{"type":26,"tag":3054,"props":3456,"children":3457},{},[3458],{"type":31,"value":3459},"发现 2",{"type":26,"tag":27,"props":3461,"children":3462},{},[3463,3465,3470],{"type":31,"value":3464},"这是否说明问题出在 ",{"type":26,"tag":3054,"props":3466,"children":3467},{},[3468],{"type":31,"value":3469},"你的猜测",{"type":31,"value":3471},"？",{"type":26,"tag":923,"props":3473,"children":3474},{},[],{"type":26,"tag":76,"props":3476,"children":3478},{"id":3477},"第三轮确认修复",[3479],{"type":31,"value":3480},"第三轮：确认修复",{"type":26,"tag":27,"props":3482,"children":3483},{},[3484],{"type":31,"value":3485},"我按照你的建议修改了代码：",{"type":26,"tag":258,"props":3487,"children":3490},{"code":3488,"language":3216,"meta":7,"className":3489},"[粘贴修改后的代码]\n",[3218],[3491],{"type":26,"tag":214,"props":3492,"children":3493},{"__ignoreMap":7},[3494],{"type":31,"value":3488},{"type":26,"tag":27,"props":3496,"children":3497},{},[3498],{"type":31,"value":3499},"请确认这个修复是否正确，以及是否有其他潜在问题。",{"type":26,"tag":923,"props":3501,"children":3502},{},[],{"type":26,"tag":76,"props":3504,"children":3506},{"id":3505},"第四轮预防",[3507],{"type":31,"value":3508},"第四轮：预防",{"type":26,"tag":27,"props":3510,"children":3511},{},[3512],{"type":31,"value":3513},"这个问题已解决。请建议：",{"type":26,"tag":431,"props":3515,"children":3516},{},[3517,3522,3527],{"type":26,"tag":399,"props":3518,"children":3519},{},[3520],{"type":31,"value":3521},"如何防止类似问题再次发生？",{"type":26,"tag":399,"props":3523,"children":3524},{},[3525],{"type":31,"value":3526},"应该添加什么测试用例？",{"type":26,"tag":399,"props":3528,"children":3529},{},[3530],{"type":31,"value":3531},"有什么最佳实践可以参考？",{"type":26,"tag":258,"props":3533,"children":3535},{"code":3534},"\n## 结语：AI 是放大器，不是替代品\n\nAI 调试工具能够显著加速问题排查过程，但它不能替代你的思考。最有价值的能力组合是：\n\n- **你的领域知识** + **AI 的广博见识**\n- **你对项目的理解** + **AI 的分析能力**\n- **你的判断力** + **AI 的执行速度**\n\n调试的本质是假设-验证的循环。AI 帮你更快地生成假设、更高效地验证假设，但做出最终判断的还是你。\n\n学会与 AI 高效协作调试，不是依赖 AI 给你答案，而是让 AI 帮你更快地找到自己的答案。\n\n---\n\n## 参考资源\n\n- [Chrome DevTools 官方文档](https://developer.chrome.com/docs/devtools)\n- [Node.js 调试指南](https://nodejs.org/en/docs/guides/debugging-getting-started)\n- [React DevTools 使用指南](https://react.dev/learn/react-developer-tools)\n",[3536],{"type":26,"tag":214,"props":3537,"children":3538},{"__ignoreMap":7},[3539],{"type":31,"value":3534},{"title":7,"searchDepth":787,"depth":787,"links":3541},[3542,3543,3544,3549,3553,3558,3562,3566,3567,3568],{"id":2925,"depth":790,"text":2928},{"id":2931,"depth":790,"text":2934},{"id":2952,"depth":790,"text":2955,"children":3545},[3546,3547,3548],{"id":2958,"depth":787,"text":2961},{"id":3036,"depth":787,"text":3039},{"id":3201,"depth":787,"text":3204},{"id":3243,"depth":790,"text":3246,"children":3550},[3551,3552],{"id":3249,"depth":787,"text":3252},{"id":3269,"depth":787,"text":3272},{"id":3289,"depth":790,"text":3292,"children":3554},[3555,3556,3557],{"id":3295,"depth":787,"text":3298},{"id":3310,"depth":787,"text":3313},{"id":3325,"depth":787,"text":3328},{"id":3342,"depth":790,"text":3345,"children":3559},[3560,3561],{"id":3348,"depth":787,"text":3351},{"id":3363,"depth":787,"text":3366},{"id":3378,"depth":790,"text":3381,"children":3563},[3564,3565],{"id":3384,"depth":787,"text":3387},{"id":3398,"depth":787,"text":3401},{"id":3432,"depth":790,"text":3435},{"id":3477,"depth":790,"text":3480},{"id":3505,"depth":790,"text":3508},"content:topics:ai:ai-debugging-troubleshooting-guide.md","topics/ai/ai-debugging-troubleshooting-guide.md","topics/ai/ai-debugging-troubleshooting-guide",{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"date":10,"topic":5,"author":11,"tags":3573,"image":17,"imageQuery":18,"pexelsPhotoId":19,"pexelsUrl":20,"featured":6,"readingTime":21,"body":3574,"_type":800,"_id":801,"_source":802,"_file":803,"_stem":804,"_extension":805},[13,14,15,16],{"type":23,"children":3575,"toc":4191},[3576,3580,3584,3608,3612,3665,3669,3673,3677,3741,3745,3749,3753,3761,3765,3769,3853,3857,3861,3865,3880,3884,3888,3892,3907,3911,3915,3919,3938,3942,3946,3954,3958,3962,3966,4052,4056,4060,4064,4068,4072,4148,4152,4156,4160],{"type":26,"tag":27,"props":3577,"children":3578},{},[3579],{"type":31,"value":32},{"type":26,"tag":27,"props":3581,"children":3582},{},[3583],{"type":31,"value":37},{"type":26,"tag":27,"props":3585,"children":3586},{},[3587,3588,3592,3593,3597,3598,3602,3603,3607],{"type":31,"value":42},{"type":26,"tag":44,"props":3589,"children":3590},{"href":46},[3591],{"type":31,"value":49},{"type":31,"value":51},{"type":26,"tag":44,"props":3594,"children":3595},{"href":54},[3596],{"type":31,"value":57},{"type":31,"value":51},{"type":26,"tag":44,"props":3599,"children":3600},{"href":61},[3601],{"type":31,"value":64},{"type":31,"value":66},{"type":26,"tag":44,"props":3604,"children":3605},{"href":69},[3606],{"type":31,"value":72},{"type":31,"value":74},{"type":26,"tag":76,"props":3609,"children":3610},{"id":78},[3611],{"type":31,"value":81},{"type":26,"tag":83,"props":3613,"children":3614},{},[3615,3629],{"type":26,"tag":87,"props":3616,"children":3617},{},[3618],{"type":26,"tag":91,"props":3619,"children":3620},{},[3621,3625],{"type":26,"tag":95,"props":3622,"children":3623},{},[3624],{"type":31,"value":99},{"type":26,"tag":95,"props":3626,"children":3627},{},[3628],{"type":31,"value":104},{"type":26,"tag":106,"props":3630,"children":3631},{},[3632,3643,3654],{"type":26,"tag":91,"props":3633,"children":3634},{},[3635,3639],{"type":26,"tag":113,"props":3636,"children":3637},{},[3638],{"type":31,"value":117},{"type":26,"tag":113,"props":3640,"children":3641},{},[3642],{"type":31,"value":122},{"type":26,"tag":91,"props":3644,"children":3645},{},[3646,3650],{"type":26,"tag":113,"props":3647,"children":3648},{},[3649],{"type":31,"value":130},{"type":26,"tag":113,"props":3651,"children":3652},{},[3653],{"type":31,"value":135},{"type":26,"tag":91,"props":3655,"children":3656},{},[3657,3661],{"type":26,"tag":113,"props":3658,"children":3659},{},[3660],{"type":31,"value":143},{"type":26,"tag":113,"props":3662,"children":3663},{},[3664],{"type":31,"value":148},{"type":26,"tag":27,"props":3666,"children":3667},{},[3668],{"type":31,"value":153},{"type":26,"tag":76,"props":3670,"children":3671},{"id":156},[3672],{"type":31,"value":159},{"type":26,"tag":27,"props":3674,"children":3675},{},[3676],{"type":31,"value":164},{"type":26,"tag":83,"props":3678,"children":3679},{},[3680,3694],{"type":26,"tag":87,"props":3681,"children":3682},{},[3683],{"type":26,"tag":91,"props":3684,"children":3685},{},[3686,3690],{"type":26,"tag":95,"props":3687,"children":3688},{},[3689],{"type":31,"value":178},{"type":26,"tag":95,"props":3691,"children":3692},{},[3693],{"type":31,"value":183},{"type":26,"tag":106,"props":3695,"children":3696},{},[3697,3708,3730],{"type":26,"tag":91,"props":3698,"children":3699},{},[3700,3704],{"type":26,"tag":113,"props":3701,"children":3702},{},[3703],{"type":31,"value":194},{"type":26,"tag":113,"props":3705,"children":3706},{},[3707],{"type":31,"value":199},{"type":26,"tag":91,"props":3709,"children":3710},{},[3711,3715],{"type":26,"tag":113,"props":3712,"children":3713},{},[3714],{"type":31,"value":207},{"type":26,"tag":113,"props":3716,"children":3717},{},[3718,3719,3724,3725],{"type":31,"value":212},{"type":26,"tag":214,"props":3720,"children":3722},{"className":3721},[],[3723],{"type":31,"value":219},{"type":31,"value":221},{"type":26,"tag":214,"props":3726,"children":3728},{"className":3727},[],[3729],{"type":31,"value":227},{"type":26,"tag":91,"props":3731,"children":3732},{},[3733,3737],{"type":26,"tag":113,"props":3734,"children":3735},{},[3736],{"type":31,"value":235},{"type":26,"tag":113,"props":3738,"children":3739},{},[3740],{"type":31,"value":240},{"type":26,"tag":27,"props":3742,"children":3743},{},[3744],{"type":31,"value":245},{"type":26,"tag":76,"props":3746,"children":3747},{"id":248},[3748],{"type":31,"value":251},{"type":26,"tag":27,"props":3750,"children":3751},{},[3752],{"type":31,"value":256},{"type":26,"tag":258,"props":3754,"children":3756},{"className":3755,"code":262,"language":263,"meta":7},[261],[3757],{"type":26,"tag":214,"props":3758,"children":3759},{"__ignoreMap":7},[3760],{"type":31,"value":262},{"type":26,"tag":27,"props":3762,"children":3763},{},[3764],{"type":31,"value":273},{"type":26,"tag":27,"props":3766,"children":3767},{},[3768],{"type":31,"value":278},{"type":26,"tag":83,"props":3770,"children":3771},{},[3772,3790],{"type":26,"tag":87,"props":3773,"children":3774},{},[3775],{"type":26,"tag":91,"props":3776,"children":3777},{},[3778,3782,3786],{"type":26,"tag":95,"props":3779,"children":3780},{},[3781],{"type":31,"value":292},{"type":26,"tag":95,"props":3783,"children":3784},{},[3785],{"type":31,"value":297},{"type":26,"tag":95,"props":3787,"children":3788},{},[3789],{"type":31,"value":302},{"type":26,"tag":106,"props":3791,"children":3792},{},[3793,3808,3823,3838],{"type":26,"tag":91,"props":3794,"children":3795},{},[3796,3800,3804],{"type":26,"tag":113,"props":3797,"children":3798},{},[3799],{"type":31,"value":313},{"type":26,"tag":113,"props":3801,"children":3802},{},[3803],{"type":31,"value":318},{"type":26,"tag":113,"props":3805,"children":3806},{},[3807],{"type":31,"value":323},{"type":26,"tag":91,"props":3809,"children":3810},{},[3811,3815,3819],{"type":26,"tag":113,"props":3812,"children":3813},{},[3814],{"type":31,"value":331},{"type":26,"tag":113,"props":3816,"children":3817},{},[3818],{"type":31,"value":336},{"type":26,"tag":113,"props":3820,"children":3821},{},[3822],{"type":31,"value":341},{"type":26,"tag":91,"props":3824,"children":3825},{},[3826,3830,3834],{"type":26,"tag":113,"props":3827,"children":3828},{},[3829],{"type":31,"value":349},{"type":26,"tag":113,"props":3831,"children":3832},{},[3833],{"type":31,"value":354},{"type":26,"tag":113,"props":3835,"children":3836},{},[3837],{"type":31,"value":359},{"type":26,"tag":91,"props":3839,"children":3840},{},[3841,3845,3849],{"type":26,"tag":113,"props":3842,"children":3843},{},[3844],{"type":31,"value":367},{"type":26,"tag":113,"props":3846,"children":3847},{},[3848],{"type":31,"value":372},{"type":26,"tag":113,"props":3850,"children":3851},{},[3852],{"type":31,"value":377},{"type":26,"tag":27,"props":3854,"children":3855},{},[3856],{"type":31,"value":382},{"type":26,"tag":76,"props":3858,"children":3859},{"id":385},[3860],{"type":31,"value":388},{"type":26,"tag":27,"props":3862,"children":3863},{},[3864],{"type":31,"value":393},{"type":26,"tag":395,"props":3866,"children":3867},{},[3868,3872,3876],{"type":26,"tag":399,"props":3869,"children":3870},{},[3871],{"type":31,"value":403},{"type":26,"tag":399,"props":3873,"children":3874},{},[3875],{"type":31,"value":408},{"type":26,"tag":399,"props":3877,"children":3878},{},[3879],{"type":31,"value":413},{"type":26,"tag":27,"props":3881,"children":3882},{},[3883],{"type":31,"value":418},{"type":26,"tag":76,"props":3885,"children":3886},{"id":421},[3887],{"type":31,"value":424},{"type":26,"tag":27,"props":3889,"children":3890},{},[3891],{"type":31,"value":429},{"type":26,"tag":431,"props":3893,"children":3894},{},[3895,3899,3903],{"type":26,"tag":399,"props":3896,"children":3897},{},[3898],{"type":31,"value":438},{"type":26,"tag":399,"props":3900,"children":3901},{},[3902],{"type":31,"value":443},{"type":26,"tag":399,"props":3904,"children":3905},{},[3906],{"type":31,"value":448},{"type":26,"tag":27,"props":3908,"children":3909},{},[3910],{"type":31,"value":453},{"type":26,"tag":76,"props":3912,"children":3913},{"id":456},[3914],{"type":31,"value":459},{"type":26,"tag":27,"props":3916,"children":3917},{},[3918],{"type":31,"value":464},{"type":26,"tag":395,"props":3920,"children":3921},{},[3922,3926,3930,3934],{"type":26,"tag":399,"props":3923,"children":3924},{},[3925],{"type":31,"value":472},{"type":26,"tag":399,"props":3927,"children":3928},{},[3929],{"type":31,"value":477},{"type":26,"tag":399,"props":3931,"children":3932},{},[3933],{"type":31,"value":482},{"type":26,"tag":399,"props":3935,"children":3936},{},[3937],{"type":31,"value":487},{"type":26,"tag":27,"props":3939,"children":3940},{},[3941],{"type":31,"value":492},{"type":26,"tag":27,"props":3943,"children":3944},{},[3945],{"type":31,"value":497},{"type":26,"tag":258,"props":3947,"children":3949},{"className":3948,"code":501,"language":263,"meta":7},[261],[3950],{"type":26,"tag":214,"props":3951,"children":3952},{"__ignoreMap":7},[3953],{"type":31,"value":501},{"type":26,"tag":27,"props":3955,"children":3956},{},[3957],{"type":31,"value":511},{"type":26,"tag":76,"props":3959,"children":3960},{"id":514},[3961],{"type":31,"value":517},{"type":26,"tag":27,"props":3963,"children":3964},{},[3965],{"type":31,"value":522},{"type":26,"tag":83,"props":3967,"children":3968},{},[3969,3983],{"type":26,"tag":87,"props":3970,"children":3971},{},[3972],{"type":26,"tag":91,"props":3973,"children":3974},{},[3975,3979],{"type":26,"tag":95,"props":3976,"children":3977},{},[3978],{"type":31,"value":536},{"type":26,"tag":95,"props":3980,"children":3981},{},[3982],{"type":31,"value":541},{"type":26,"tag":106,"props":3984,"children":3985},{},[3986,3997,4008,4019,4030,4041],{"type":26,"tag":91,"props":3987,"children":3988},{},[3989,3993],{"type":26,"tag":113,"props":3990,"children":3991},{},[3992],{"type":31,"value":552},{"type":26,"tag":113,"props":3994,"children":3995},{},[3996],{"type":31,"value":557},{"type":26,"tag":91,"props":3998,"children":3999},{},[4000,4004],{"type":26,"tag":113,"props":4001,"children":4002},{},[4003],{"type":31,"value":565},{"type":26,"tag":113,"props":4005,"children":4006},{},[4007],{"type":31,"value":570},{"type":26,"tag":91,"props":4009,"children":4010},{},[4011,4015],{"type":26,"tag":113,"props":4012,"children":4013},{},[4014],{"type":31,"value":578},{"type":26,"tag":113,"props":4016,"children":4017},{},[4018],{"type":31,"value":583},{"type":26,"tag":91,"props":4020,"children":4021},{},[4022,4026],{"type":26,"tag":113,"props":4023,"children":4024},{},[4025],{"type":31,"value":591},{"type":26,"tag":113,"props":4027,"children":4028},{},[4029],{"type":31,"value":596},{"type":26,"tag":91,"props":4031,"children":4032},{},[4033,4037],{"type":26,"tag":113,"props":4034,"children":4035},{},[4036],{"type":31,"value":604},{"type":26,"tag":113,"props":4038,"children":4039},{},[4040],{"type":31,"value":609},{"type":26,"tag":91,"props":4042,"children":4043},{},[4044,4048],{"type":26,"tag":113,"props":4045,"children":4046},{},[4047],{"type":31,"value":617},{"type":26,"tag":113,"props":4049,"children":4050},{},[4051],{"type":31,"value":622},{"type":26,"tag":27,"props":4053,"children":4054},{},[4055],{"type":31,"value":627},{"type":26,"tag":76,"props":4057,"children":4058},{"id":630},[4059],{"type":31,"value":633},{"type":26,"tag":27,"props":4061,"children":4062},{},[4063],{"type":31,"value":638},{"type":26,"tag":27,"props":4065,"children":4066},{},[4067],{"type":31,"value":643},{"type":26,"tag":76,"props":4069,"children":4070},{"id":646},[4071],{"type":31,"value":649},{"type":26,"tag":395,"props":4073,"children":4075},{"className":4074},[653],[4076,4084,4092,4100,4108,4116,4124,4132,4140],{"type":26,"tag":399,"props":4077,"children":4079},{"className":4078},[658],[4080,4083],{"type":26,"tag":661,"props":4081,"children":4082},{"disabled":663,"type":664},[],{"type":31,"value":667},{"type":26,"tag":399,"props":4085,"children":4087},{"className":4086},[658],[4088,4091],{"type":26,"tag":661,"props":4089,"children":4090},{"disabled":663,"type":664},[],{"type":31,"value":676},{"type":26,"tag":399,"props":4093,"children":4095},{"className":4094},[658],[4096,4099],{"type":26,"tag":661,"props":4097,"children":4098},{"disabled":663,"type":664},[],{"type":31,"value":685},{"type":26,"tag":399,"props":4101,"children":4103},{"className":4102},[658],[4104,4107],{"type":26,"tag":661,"props":4105,"children":4106},{"disabled":663,"type":664},[],{"type":31,"value":694},{"type":26,"tag":399,"props":4109,"children":4111},{"className":4110},[658],[4112,4115],{"type":26,"tag":661,"props":4113,"children":4114},{"disabled":663,"type":664},[],{"type":31,"value":703},{"type":26,"tag":399,"props":4117,"children":4119},{"className":4118},[658],[4120,4123],{"type":26,"tag":661,"props":4121,"children":4122},{"disabled":663,"type":664},[],{"type":31,"value":712},{"type":26,"tag":399,"props":4125,"children":4127},{"className":4126},[658],[4128,4131],{"type":26,"tag":661,"props":4129,"children":4130},{"disabled":663,"type":664},[],{"type":31,"value":721},{"type":26,"tag":399,"props":4133,"children":4135},{"className":4134},[658],[4136,4139],{"type":26,"tag":661,"props":4137,"children":4138},{"disabled":663,"type":664},[],{"type":31,"value":730},{"type":26,"tag":399,"props":4141,"children":4143},{"className":4142},[658],[4144,4147],{"type":26,"tag":661,"props":4145,"children":4146},{"disabled":663,"type":664},[],{"type":31,"value":739},{"type":26,"tag":76,"props":4149,"children":4150},{"id":742},[4151],{"type":31,"value":742},{"type":26,"tag":27,"props":4153,"children":4154},{},[4155],{"type":31,"value":749},{"type":26,"tag":27,"props":4157,"children":4158},{},[4159],{"type":31,"value":754},{"type":26,"tag":395,"props":4161,"children":4162},{},[4163,4170,4177,4184],{"type":26,"tag":399,"props":4164,"children":4165},{},[4166],{"type":26,"tag":44,"props":4167,"children":4168},{"href":46},[4169],{"type":31,"value":49},{"type":26,"tag":399,"props":4171,"children":4172},{},[4173],{"type":26,"tag":44,"props":4174,"children":4175},{"href":54},[4176],{"type":31,"value":57},{"type":26,"tag":399,"props":4178,"children":4179},{},[4180],{"type":26,"tag":44,"props":4181,"children":4182},{"href":61},[4183],{"type":31,"value":64},{"type":26,"tag":399,"props":4185,"children":4186},{},[4187],{"type":26,"tag":44,"props":4188,"children":4189},{"href":69},[4190],{"type":31,"value":72},{"title":7,"searchDepth":787,"depth":787,"links":4192},[4193,4194,4195,4196,4197,4198,4199,4200,4201,4202],{"id":78,"depth":790,"text":81},{"id":156,"depth":790,"text":159},{"id":248,"depth":790,"text":251},{"id":385,"depth":790,"text":388},{"id":421,"depth":790,"text":424},{"id":456,"depth":790,"text":459},{"id":514,"depth":790,"text":517},{"id":630,"depth":790,"text":633},{"id":646,"depth":790,"text":649},{"id":742,"depth":790,"text":742},1778637709674]