外观
文末「相关面试题」怎么写(占位规范)
难度与前置
难度:入门
前置:会按 Frontmatter 约定 写技术文骨架;理解文末区块是「引流 + 自测入口」,不是第二篇题解。
读完能做什么:给任意实践文补上合规的「相关面试题」脚注;审校时能用作者清单一票否决不合规脚注。
适用场景
- 新写 / 改写技术专篇,需要统一文末「相关面试题」格式
- 审校同学检查脚注是否超条数、是否贴了泄密级题解
- 读者看到占位符时,知道「题库未接通」与「考察点已写清」分别意味着什么
- 后续接通微信题库小程序时,只换链接、不改考察点写法(见 与题库小程序联动)
不适用:
- 在本站粘贴完整标准答案、内部口径数字、真实告警阈值(禁止)
- 替代 学习路径导读 的岗位阅读顺序
- 替代专篇正文的「如何验收」(面试题应映射验收能力,不重复写步骤长文)
- 小程序题库 CMS / 目录结构本身(不在
website/改miniprogram/)
真实场景(一条)
短剧投放主题的「离线幂等」专篇成稿时,作者在文末贴了 12 道题,其中 3 道带完整 SQL 与「生产日均 2.3 亿行、差错率 0.02%」等内部口径。审校打回:条数超限、题解过长、数字像真实业务。按本规范改成 4 道勾选占位,每题只写「题干一句 + 考察点(对齐本文验收)+ miniprogram://q/<id> 或 #todo-interview-<slug>」。合入后读者仍能自测「会不会讲」,题库上线只需替换占位,不必重写正文。
怎么做(步骤清单)
1. 强制区块模板(每篇技术文文末)
在 ## 如何验收(及可选的相关专篇互链)之后,必须出现同名二级标题,推荐直接复制:
markdown
## 相关面试题
> 题库小程序链接待定;先用站内锚点占位。
- [ ] 题:……(考察点:……)→ 占位:`miniprogram://q/<id>` 或 `#todo-interview-<slug>`
- [ ] 题:……(考察点:……)→ 占位:`#todo-interview-<slug>`
- [ ] 题:……(考察点:……)→ 占位:`#todo-interview-<slug>`说明:
| 元素 | 要求 |
|---|---|
| 标题 | 固定为 ## 相关面试题(与 frontmatter 结构建议第 7 项 一致) |
| 提示行 | 保留 blockquote;题库 URL 未定时不要编造公网短链 |
| 列表 | Markdown 任务列表 - [ ];便于读者本地勾选 |
| 题干 | 一句场景化问法,避免纯名词解释 |
| 考察点 | 括号内写清「对齐本文哪条验收能力」 |
| 占位 | miniprogram://q/<id>(已有题号时)或 #todo-interview-<slug>(未建题时) |
2. 条数与选题规则
- 每篇 3~5 题,含端点;少于 3 题通常说明没绑验收,多于 5 题说明在堆砌。
- 每题必须能映射到本文「如何验收」中至少一条可测能力(步骤讲清 / 坑能避 / 数字能核)。
- 优先「能讲清步骤 + 坑 + 验收」,禁止冷僻 trivia(版本号默写、无关产品对比)。
- 允许 1 题做「边界 / 不适用」考察,防止读者只会快乐路径。
- 跨专篇对比题最多 1 道,且链到已存在路径(如分层 vs 质量闭环),不要悬空链接。
3. 禁止写入脚注的内容
- 完整可运行的「标准答案」长文(题解留在小程序;本站最多一句提示方向)
- 未公开的公司项目名、真实表名风格、真实 SLA 数字、真实 PII
- 伪造的小程序短链、二维码图床、未审定的
https://题库域名 - 把「相关面试题」改成广告文案或与本篇无关的引流列表
需要引流话术时,统一跟 与题库小程序联动 的 Footer CTA 占位,不在本题区发明第二套 URL。
4. 与 Frontmatter / 正文骨架的关系
Frontmatter 约定「正文结构建议」第 7 项即本区块。作者流程:
- 先写完适用场景 → 怎么做 → 常见坑 → 如何验收
- 从验收表抽出 3~5 个「口头能讲清」的能力点
- 按上表模板生成脚注
- 自检(见下方验收)通过后再标
status(若使用)
规范页自身也使用同一脚注格式——考察的是「你会不会写规范」,而不是再贴一套假题库。
5. 合格 / 不合格对照(短剧投放语境)
合格示例(节选):
markdown
## 相关面试题
> 题库小程序链接待定;先用站内锚点占位。
- [ ] 题:投放日分区重跑两次,如何证明没有翻倍?(考察点:幂等双跑 diff=0)→ 占位:`#todo-interview-idempotent-double-run`
- [ ] 题:什么情况下不该用「删分区再插」?如何验收替代方案?(考察点:不适用边界 + 验收数字)→ 占位:`#todo-interview-idempotent-when-not`不合格示例(不要这样):
- 一次贴 10 题,考察点写「综合」
- 题下跟 80 行标准 SQL + 「我们生产差错率 0.00x%」
- 占位写成
https://example.com/fake-quiz/123假装已上线 - 题干与本文验收无关(例如在分层文末问 RocksDB 调优细节)
常见坑(至少这些)
- 条数膨胀到「题库目录」
文末不是小程序首页。 - 题干只有名词,无场景
「什么是幂等?」不如「分区重跑如何证明不翻倍?」 - 考察点与本文验收脱节
读完专篇仍答不上脚注题 = 脚注失败。 - 粘贴完整题解或内部指标
泄露与维护双炸;且与小程序抢职责。 - 编造可点击的假 URL
读者 404;统一用明确占位符。 - 漏掉 blockquote 提示行
后人误以为题库已接通。 - 把 stub 页、草稿页也强行堆 5 道题
跳转 stub 不应进侧栏,也不宜当主文维护长脚注。
如何验收(作者合规清单)
合并前用下表自检;任一项否 = 打回修改。
| 检查项 | 达标标准 |
|---|---|
| 标题 | 恰好 ## 相关面试题 |
| 提示 | 含「题库小程序链接待定」类 blockquote |
| 条数 | 3≤N≤5 |
| 映射 | 每题考察点能指回本文验收中的具体能力 |
| 占位 | 仅 miniprogram://q/<id> 或 #todo-interview-<slug>,无假公网题库链 |
| 题解 | 无大段标准答案;无真实机密数字 / PII |
| 风格 | 任务列表 - [ ];题干场景化 |
text
文末面试题审校记录(可复制)
文章路径:docs/..../xx.md
题数:____(3~5)
考察点 ↔ 验收行:已勾 / 未勾
占位类型:miniprogram:// / #todo-interview-
含完整题解:是* / 否(*则打回)
含内部指标或真实表名:是* / 否
审校:________ 日期:________Checklist:
- [ ] 模板结构完整(标题 + 提示 + 3~5 条任务项)
- [ ] 每题对齐本篇验收,而非外篇 trivia
- [ ] 未编辑
miniprogram/;未发明假 URL - [ ] 已在 frontmatter 结构建议 语境下可被引用
- [ ] 读者向说明:占位 ≠ 坏链,是待接通
相关面试题
本题区示范「规范页自己的脚注」:考察作者是否会按规范写脚注,而非考察数仓技术点。题库小程序链接待定;先用站内锚点占位。
- [ ] 题:技术文文末「相关面试题」强制包含哪些元素?少了哪一项应打回?(考察点:标题/提示/条数/占位格式)→ 占位:
#todo-interview-related-interview-template - [ ] 题:为何要把考察点绑到本文「如何验收」,而不是随便抽名词题?(考察点:验收能力映射)→ 占位:
#todo-interview-related-interview-map-check - [ ] 题:什么样的脚注内容必须删除(题解长度、机密数字、假链接)?(考察点:禁止项)→ 占位:
#todo-interview-related-interview-forbid - [ ] 题:题库上线后,网站侧应改正文题干还是只替换占位链接?(考察点:与小程序联动边界)→ 占位:
#todo-interview-related-interview-swap-link