码农如何写技术博客：不装不炫，写点真有用的

上周五晚上改完线上 bug，凌晨一点躺床上刷手机，看到一篇讲 Redis 缓存穿透的博客，配图是手绘流程图，代码就三行，但把问题、解法、踩坑全说清了。我顺手收藏，第二天就用上了——这比翻官方文档快多了。

别等“准备好”了再写

很多同事说：“等我把这个框架吃透再写”，结果一年过去，笔记还在草稿箱里。其实你刚 debug 完一个 Spring Boot 启动失败的问题，把 spring.main.web-application-type=none 这行配置加进去才跑起来，这就是一篇好博客的胚子。真实、即时、带情绪（比如“试了七次才搞定”），反而让人信。

结构不用花哨，三块就够了

场景：谁会遇到这个问题？比如“用 Jenkins 构建 Node 项目时提示 npm ERR! Missing script: "build"”。
原因：不是 npm 没装好，是 Jenkins 工作目录没切对，或者 package.json 里真没写 build 脚本。
解法：贴出 Jenkinsfile 片段：

sh 'cd ./frontend && npm install && npm run build'

再补一句：“注意，别漏掉 cd ./frontend，Jenkins 默认在根目录执行。”

代码截图不如直接贴可复制的代码

截图里的小字号、模糊边框、遮挡文字，看着就累。直接上

# .gitignore 示例
node_modules/
.env
/dist
*.log

别人 Ctrl+C / Ctrl+V 就能用。如果要强调某一行，加个注释就行：

docker run -p 8080:8080 \
  -v $(pwd)/config.yml:/app/config.yml \  # ← 注意路径映射写法
  my-spring-app

标题别写“浅谈分布式系统设计”，试试这些

• “Git rebase 后 PR 变成 37 个 commit？三步压平它”
• “IntelliJ IDEA 卡成 PPT？关掉这个插件立竿见影”
• “Python requests 报 SSL error？不是证书问题，是公司代理在中间搞鬼”
标题里有动作、有结果、有具体工具，点击率立马不一样。

发布平台？先发到自己 GitHub Pages 或语雀，别纠结

有人卡在“选 Hexo 还是 VuePress”，结果半年没写。其实用 Typora 写完，导出 HTML，扔进 GitHub 仓库，开 Pages，链接发到公司群，有人问你就回：“我写了，链接在这”。流量不重要，写下去才重要。你写的第 5 篇，可能就被新来的实习生搜到了，他照着操作省了两小时——这就值了。