跳到主要内容
万两金的个人博客

技术博客发布前自查清单

约 2 分钟阅读 修订于 2026年9月10日

发布前过一遍清单,比发出去再改要省事。这份清单分两部分:内容本身,以及个人站点的额外注意项。

内容自查

技术结论

  • 结论是否自己跑通过?没跑通的要明确标注「待验证」
  • 命令、代码片段是否可以直接复制运行?缺依赖的要补上
  • 有没有把「在我机器上是好的」当成通用结论

版本与时效

  • 涉及的版本号是否写清楚?技术文章不写版本基本等于不可复现
  • 是否标注了写作时间?API 会变,读者需要知道时效边界

引用与来源

  • 参考的官方文档、他人文章是否标注了链接
  • 转载内容是否获得授权;没授权就只做引用加自己的分析
  • 图片、示意图的来源是否清晰

敏感信息

这是最容易疏忽的一块,尤其是从工作场景里带出来的内容。

  • 手机号、身份证号、真实姓名等个人信息是否脱敏
  • 内网地址、域名、主机名、账号 ID 是否替换成占位符
  • 截图里是否有工单号、聊天记录、客户信息
  • 公司内部的项目名、接口地址、业务数据是否出现

一条经验:先假设截图里的每个角落都会被看到,再决定要不要发。

个人备案站点的额外边界

本站是个人非经营性备案,所以在内容范围上需要守住几条线:

  • 不写时政、新闻类内容
  • 不写金融投资建议、医疗健康指导等需要资质的领域
  • 不出现企业宣传、产品报价、招聘承接类信息
  • 不放置广告、推广链接、返利或邀请码
  • 不做用户注册与评论,保持零用户生成内容

这几条不是为了限制写作,而是为了让站点性质始终清晰:一个个人学习记录站点。

发布动作

  • 本地构建是否通过?有没有死链
  • 站点地图是否需要重新提交
  • 摘要(description)是否控制在合理长度,能否独立看懂

清单不用很长,关键是每次都过一遍。