ch-0017 Appendix A: Fix Common Problems
- 原书章节: Appendix A Fix Common Problems（pp. 429–443）
- 输入来源: 本地 pdf（HandsOnDataViz.pdf）
摘要
排查手册：工具或平台出错时如何诊断与修复——"弄明白它为什么坏，是理解它背后原理的 绝佳途径"。开头教读者如何求助：清楚描述问题、说明操作系统/浏览器版本、附截图（附录 给出 Chromebook / Mac / Windows 的截图快捷键）。按症状分节：
- Tool or platform problems：先查官方文档/FAQ、看平台状态页（status page）、区分 是工具故障还是自己的操作问题
- Try a different browser：很多问题源于浏览器，换 Firefox / Chrome / Safari / Edge 即可；勿用已停止维护的 Internet Explorer / Edge Legacy（微软 2020 年宣布退役）
- Diagnose with developer tools：用浏览器开发者工具（F12）的 Console 窗口看报错 信息，是定位代码/数据问题的关键手段
- Mac or Chromebook problems：Mac 需注意文件扩展名显示等设置；Chromebook 能跑 大部分网页工具（Google Sheets、My Maps、Datawrapper 等）
- Watch out for bad data：很多"工具问题"其实是数据问题——如 Google Sheets 驱动的地图 里有空行会直接弄坏地图（衔接 ch-0013）；常见报错
Uncaught Error: Invalid LatLng object: (NaN, NaN)即坐标数据缺失/非法 - Common iframe errors：嵌入不显示时先回 ch-0010 核对 embed code；可用 W3Schools TryIt 页面隔离测试 iframe
- Fix your code on GitHub：改代码出错时回到 ch-0011 的流程检查（分支、文件路径、
EDIT here位置、Pages 发布是否生效）
要点归纳
- 排错顺序：数据 → 浏览器 → 工具/平台 → 代码；多数"神秘故障"源头是坏数据
- 浏览器 Console 是免费且最直接的诊断窗口
- Google Sheets 里的空行/空单元格会生成 NaN 坐标，弄坏 Leaflet 地图
- 换浏览器 + 看状态页，能解决大部分平台问题
- 求助时给足信息：症状、系统/浏览器版本、截图
术语 / 概念
- developer tools（开发者工具） — 浏览器内置的调试面板，重点是 Console
- Console（控制台） — 显示 JS 报错与日志的窗口
- status page（状态页） — 服务商公布在线/故障状态的页面
- NaN（Not a Number） — 非法数值；地图报错
Invalid LatLng object: (NaN, NaN)通常表示坐标字段缺失 - iframe errors — 嵌入不显示/变形等问题的总称（对应 ch-0010）
原句摘录
Figuring out why it broke—and how to fix it—can be a great way to learn what's happening behind the scenes.
Some of the thorniest problems may be caused by two or more separate issues.
疑问 / 待查
- 附录 B（Publishing with Bookdown）未含在本 PDF 内——作者用 Bookdown + GitHub + Zotero 写作本书的工作流，可另查 HandsOnDataViz.org
- 截图快捷键清单可整理成速查表备用
Backlinks (1)
flowchart LR
n0["ch-0001 凶案、侦探与母亲的信（第 2–163 章）"]
n1["ch-0002 坦白、出逃与和解（第 163–233 章）"]
n2["The Curious Incident of the Dog in the Night-Time 人物"]
n3["The Curious Incident of the Dog in the Night-Time（整理完成）"]
n4["The Curious Incident of the Dog in the Night-Time 笔记"]
n5["The Curious Incident of the Dog in the Night-Time 故事线"]
n6["E-Commerce Bench（整理完成）"]
n7["E-Commerce Bench 笔记"]
n8["part-0001 摘要与引言：一年期电商运营基准（Abstract + §1）"]
n9["part-0002 相关工作与定位：continuing 任务谱系（Table 1 + §2）"]
n10["part-0003 基准设计：四层架构与确定性经济（§3 主体）"]
n11["part-0004 实验结果：18 模型的多维画像（Table 2 + §4）"]
n12["part-0005 结论与参考文献（§5 + References）"]
n13["part-0006 工具集与 agent harness：18 工具与上下文管理（Table 3 + Appendix A）"]
n14["part-0007 数据层：类目、店型、日历与供应商（Appendix B）"]
n15["part-0008 经济引擎：13 步结算与需求/退货/成本公式（Table 7 + Appendix C）"]
n16["part-0009 确定性谈判内核：决策函数与骗局目录（Appendix D）"]
n17["part-0010 评测指标定义：六个维度与统计口径（Appendix E）"]
n18["part-0011 每维度结果导览与模型/实验设置（Table 10 + Appendix F）"]
n19["part-0012 失败案例研究：骗局实录与一次破产（Appendix G）"]
n20["part-0013 失败模式规则表与提示词设计（Table 18 + Appendix H）"]
n21["The End of Software Engineering（整理完成）"]
n22["The End of Software Engineering 笔记"]
n23["part-0001 摘要与引言：范式重构的宣告（Abstract + §1 前段）"]
n24["part-0002 第一性原理：传统软件与 Agent 系统的形式化模型（§1 后段 + §2）"]
n25["part-0003 三代交付史与 AI→Software→Result 的失败（§3.1–3.2）"]
n26["part-0004 Agent→Result 与 Agentic Engineering 学科（§3.3 + §4）"]
n27["part-0005 实证证据与 EvoClaw 落差（§5）"]
n28["part-0006 四阶段演进路线图（前段：表 3 + Stage I–III）"]
n29["part-0007 路线图后段与建议：实践者与研究者（§6.3 后段 + §6.4 + §7.1–7.2）"]
n30["ch-0001 Introduction（为什么做数据可视化）"]
n31["ch-0002 选工具讲你的数据故事（Ch 1）"]
n32["ch-0003 强化电子表格技能（Ch 2）"]
n33["ch-0004 找到并质询你的数据（Ch 3）"]
n34["ch-0005 清洗脏数据（Ch 4）"]
n35["ch-0006 做有意义的比较（Ch 5）"]
n36["ch-0007 图表化你的数据（Ch 6）"]
n37["ch-0008 地图化你的数据（Ch 7）"]
n38["ch-0009 表格化你的数据（Ch 8）"]
n39["ch-0010 嵌入网页（Ch 9）"]
n40["ch-0011 用 GitHub 编辑与托管代码（Ch 10）"]
n41["ch-0012 Chart.js 与 Highcharts 模板（Ch 11）"]
n42["ch-0013 Leaflet 地图模板（Ch 12）"]
n43["ch-0014 转换你的地图数据（Ch 13）"]
n44["ch-0015 识别谎言、减少偏差（Ch 14）"]
n45["ch-0016 讲述并展示你的数据故事（Ch 15）"]
n46["ch-0017 附录 A 排查常见问题"]
n47["Hands-On Data Visualization（整理完成）"]
n48["Hands-On Data Visualization 笔记"]
n49["Reading"]
n0 --> n4
n3 --> n0
n3 --> n1
n3 --> n2
n3 --> n4
n3 --> n5
n5 --> n3
n6 --> n7
n6 --> n8
n6 --> n9
n6 --> n10
n6 --> n11
n6 --> n12
n6 --> n13
n6 --> n14
n6 --> n15
n6 --> n16
n6 --> n17
n6 --> n18
n6 --> n19
n6 --> n20
n21 --> n22
n21 --> n23
n21 --> n24
n21 --> n25
n21 --> n26
n21 --> n27
n21 --> n28
n21 --> n29
n22 --> n21
n47 --> n30
n47 --> n31
n47 --> n32
n47 --> n33
n47 --> n34
n47 --> n35
n47 --> n36
n47 --> n37
n47 --> n38
n47 --> n39
n47 --> n40
n47 --> n41
n47 --> n42
n47 --> n43
n47 --> n44
n47 --> n45
n47 --> n46
n47 --> n48
n49 --> n3
n49 --> n6
n49 --> n21
n49 --> n47
click n0 "../../curious-incident/ch-0001/" "ch-0001 凶案、侦探与母亲的信（第 2–163 章）"
click n1 "../../curious-incident/ch-0002/" "ch-0002 坦白、出逃与和解（第 163–233 章）"
click n2 "../../curious-incident/characters/" "The Curious Incident of the Dog in the Night-Time 人物"
click n3 "../../curious-incident/" "The Curious Incident of the Dog in the Night-Time（整理完成）"
click n4 "../../curious-incident/notes/" "The Curious Incident of the Dog in the Night-Time 笔记"
click n5 "../../curious-incident/storyline/" "The Curious Incident of the Dog in the Night-Time 故事线"
click n6 "../../e-commerce-bench/" "E-Commerce Bench（整理完成）"
click n7 "../../e-commerce-bench/notes/" "E-Commerce Bench 笔记"
click n8 "../../e-commerce-bench/part-0001/" "part-0001 摘要与引言：一年期电商运营基准（Abstract + §1）"
click n9 "../../e-commerce-bench/part-0002/" "part-0002 相关工作与定位：continuing 任务谱系（Table 1 + §2）"
click n10 "../../e-commerce-bench/part-0003/" "part-0003 基准设计：四层架构与确定性经济（§3 主体）"
click n11 "../../e-commerce-bench/part-0004/" "part-0004 实验结果：18 模型的多维画像（Table 2 + §4）"
click n12 "../../e-commerce-bench/part-0005/" "part-0005 结论与参考文献（§5 + References）"
click n13 "../../e-commerce-bench/part-0006/" "part-0006 工具集与 agent harness：18 工具与上下文管理（Table 3 + Appendix A）"
click n14 "../../e-commerce-bench/part-0007/" "part-0007 数据层：类目、店型、日历与供应商（Appendix B）"
click n15 "../../e-commerce-bench/part-0008/" "part-0008 经济引擎：13 步结算与需求/退货/成本公式（Table 7 + Appendix C）"
click n16 "../../e-commerce-bench/part-0009/" "part-0009 确定性谈判内核：决策函数与骗局目录（Appendix D）"
click n17 "../../e-commerce-bench/part-0010/" "part-0010 评测指标定义：六个维度与统计口径（Appendix E）"
click n18 "../../e-commerce-bench/part-0011/" "part-0011 每维度结果导览与模型/实验设置（Table 10 + Appendix F）"
click n19 "../../e-commerce-bench/part-0012/" "part-0012 失败案例研究：骗局实录与一次破产（Appendix G）"
click n20 "../../e-commerce-bench/part-0013/" "part-0013 失败模式规则表与提示词设计（Table 18 + Appendix H）"
click n21 "../../end-of-software-engineering/" "The End of Software Engineering（整理完成）"
click n22 "../../end-of-software-engineering/notes/" "The End of Software Engineering 笔记"
click n23 "../../end-of-software-engineering/part-0001/" "part-0001 摘要与引言：范式重构的宣告（Abstract + §1 前段）"
click n24 "../../end-of-software-engineering/part-0002/" "part-0002 第一性原理：传统软件与 Agent 系统的形式化模型（§1 后段 + §2）"
click n25 "../../end-of-software-engineering/part-0003/" "part-0003 三代交付史与 AI→Software→Result 的失败（§3.1–3.2）"
click n26 "../../end-of-software-engineering/part-0004/" "part-0004 Agent→Result 与 Agentic Engineering 学科（§3.3 + §4）"
click n27 "../../end-of-software-engineering/part-0005/" "part-0005 实证证据与 EvoClaw 落差（§5）"
click n28 "../../end-of-software-engineering/part-0006/" "part-0006 四阶段演进路线图（前段：表 3 + Stage I–III）"
click n29 "../../end-of-software-engineering/part-0007/" "part-0007 路线图后段与建议：实践者与研究者（§6.3 后段 + §6.4 + §7.1–7.2）"
click n30 "../ch-0001/" "ch-0001 Introduction（为什么做数据可视化）"
click n31 "../ch-0002/" "ch-0002 选工具讲你的数据故事（Ch 1）"
click n32 "../ch-0003/" "ch-0003 强化电子表格技能（Ch 2）"
click n33 "../ch-0004/" "ch-0004 找到并质询你的数据（Ch 3）"
click n34 "../ch-0005/" "ch-0005 清洗脏数据（Ch 4）"
click n35 "../ch-0006/" "ch-0006 做有意义的比较（Ch 5）"
click n36 "../ch-0007/" "ch-0007 图表化你的数据（Ch 6）"
click n37 "../ch-0008/" "ch-0008 地图化你的数据（Ch 7）"
click n38 "../ch-0009/" "ch-0009 表格化你的数据（Ch 8）"
click n39 "../ch-0010/" "ch-0010 嵌入网页（Ch 9）"
click n40 "../ch-0011/" "ch-0011 用 GitHub 编辑与托管代码（Ch 10）"
click n41 "../ch-0012/" "ch-0012 Chart.js 与 Highcharts 模板（Ch 11）"
click n42 "../ch-0013/" "ch-0013 Leaflet 地图模板（Ch 12）"
click n43 "../ch-0014/" "ch-0014 转换你的地图数据（Ch 13）"
click n44 "../ch-0015/" "ch-0015 识别谎言、减少偏差（Ch 14）"
click n45 "../ch-0016/" "ch-0016 讲述并展示你的数据故事（Ch 15）"
click n46 "./" "ch-0017 附录 A 排查常见问题"
click n47 "../" "Hands-On Data Visualization（整理完成）"
click n48 "../notes/" "Hands-On Data Visualization 笔记"
click n49 "../../" "Reading"