M9 · 编写一个易错点页面

目标

• 写下你犯过的一个错误，使后来的人能从现象认出它。
• 解释其机理、把它与其他原因区分开的检查方法，以及解决方法，每一项都有来源支持。
• 使页面以英文、韩文和中文通过本站的检查，或将韩文和中文页面标为待完成（pending）。

开始之前

• 阅读易错点各页面，了解其写法，并阅读仓库中的模板 docs/GOTCHA_TEMPLATE.md。
• 阅读 PRIVACY_RULES.md：不得包含任何来自真实项目的内容，也不得出现机构、设备或部署地点的名称。

步骤

1. 选择错误

选一个你自己犯过的错误，按你最初看到的现象来描述它，即你知道原因之前看到的样子。去掉一切属于其所在项目的内容：页面必须适用于任何设计。

2. 复现

尽可能用本站自己的工具展示其机理。变换器层面的错误常常可以在仿真器中展示，关于锁定电源电压的固定占空比反激变换器的易错点就是这样做的。例如，仿真器中向固定电压供电的降压变换器预设，显示的电感电流始终无法稳定：

▶ 在仿真器中打开：降压
预设取自例题 sim-buck-fixed

3. 编写页面

按模板编写：先是标签，然后是现象、原因、如何确认、解决方法和参考资料。每个数值都要通过合成（synthetic）示例给出（examples/synthetic/<name>.yaml，用 <Val> 显示），或取自同一行上引用的来源。用 <EqRef> 链接公式；新公式要先加入 equations.yaml。

4. 为每项论断提供来源

关于器件或方法的每项陈述，都要引用 references.bib 中的来源。新条目在其 DOI 或 URL 被打开并核对一致之前，保留 VERIFY 标记；在此之前，任何已发布的页面都不得引用它。

5. 运行检查

运行 python scripts/modulelint.py、python scripts/privacy_scan.py、python scripts/mathlint.py 和 python scripts/refcheck.py，然后运行 npm run build。在 docs/STATUS.md 中添加该页面的行，编写韩文和中文页面，或在该文件中将它们标为待完成（中文页面在中文表中单独占一行）。若希望页面发布到本站，就提交拉取请求。

验收标准

• 你自己犯过的一个错误，按最初看到的现象描述，不含其所在项目的任何内容。
• 页面遵循模板：先是标签，然后是现象、原因、如何确认、解决方法和参考资料。
• 每个数值都通过 <Val> 取自合成示例，或取自同一行上引用的来源。
• 关于器件或方法的每项论断，都引用 references.bib 中经过核实的条目。
• modulelint、privacy_scan、mathlint 和 refcheck 均通过，且站点能够构建。
• 韩文页面，或 STATUS 中将其标为待完成的一行。
• 中文页面，或 STATUS 中文表中将其标为待完成的一行。

重置此任务

勾选记录只保存在此浏览器中：无需账号，也不发送任何数据。

易错点

• 带着已知原因去描述的现象，对尚未找到原因的人毫无帮助。描述你看到的情况。
• 不得使用你所从事项目中的数值，即使经过舍入也不行。应建立一个合成示例，用取整的数值显示同样的效应。
• 没有检验的解决方法只是猜测：要说明如何判断解决方法已经生效。

延伸阅读

• 应用笔记 Impedance Measurement Handbook (5950-3000) — Keysight Technologies · 访问于 2026-09-24
  LCR 测试仪和阻抗分析仪的测量原理，元件测量值为何取决于测试频率和测试信号，以及如何连接和补偿测试夹具（test fixture）。
• 应用笔记 Low Level Measurements Handbook, 7th edition — Keithley Instruments (Tektronix) · 访问于 2026-09-24
  精密直流测量，其中包括用四线（开尔文）法测量低电阻，该方法使表笔的电阻不计入读数。

测验

1. 易错点页面上的数值可以来自哪里？

   1. 来自发生该错误的项目，经过舍入
   2. 来自用 <Val> 显示的合成示例，或来自同一行上引用的来源
   3. 来自记忆
   4. 来自任意网页
   答案与解析

   正确答案：B 隐私规则允许附有来源的教材或数据手册数值，以及合成示例的数值；来自真实项目的数值一律不允许，即使经过舍入。

2. 哪一节告诉读者如何确定他们看到的正是这个易错点？

   1. 现象
   2. 原因
   3. 如何确认
   4. 参考资料
   答案与解析

   正确答案：C 同一现象可能有多种原因。“如何确认”给出能把这一原因与其他原因区分开的测量或检查。

3. 一个新的参考文献条目仍带有 VERIFY 标记。页面可以引用它吗？

   1. 可以，只要标题看起来没错
   2. 不可以：在打开 DOI 或 URL 并核对一致、删除该标记之前，refcheck 都会失败
   3. 可以，但只能在韩文页面中
   4. 只能在脚注中
   答案与解析

   正确答案：B 已发布的页面不得引用未经核实的条目，以免有引用指向无人核对过的内容。

4. 韩文页面尚未编写。本站需要什么？

   1. 什么都不需要
   2. docs/STATUS.md 中将韩文页面标为待完成的一行
   3. 机器翻译
   4. 把英文页面移出 08-gotchas
   答案与解析

   正确答案：B 只有当 STATUS 将韩文页面标为待完成时，modulelint 才接受没有对应韩文页面的英文页面。

5. 为什么要先描述现象，再描述原因？

   1. 因为模板按字母顺序排列各节
   2. 因为需要这个页面的读者只知道自己看到了什么，还不知道原因
   3. 因为原因很难写
   4. 无关紧要
   答案与解析

   正确答案：B 易错点是通过现象找到的。若带着原因来写，它就与后来的人在实验台上看到的情况对不上。