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