如何才算一篇好的技术文章

[xiaofan2]

如题，最近突然想写一些技术文章，想问问各位你们眼中的好的技术文章是什么样子的？ 技术方向是 Java 以及数据库 中间件相关

[murmur]

少吹牛逼多说坑，现在很多文章就是对着新技术一顿爆吹，他遇到什么问题，怎么解决的，一点也不说

[pushback]

先排除 CV （重点批评某平台恰烂钱文章）

[dilu]

1 、xxx 是什么
2 、xxx 的优点 缺点 解决了什么问题
3 、xxx 的底层原理 或者源码实现分析
4 、xxx 的横向扩展技术 yyy 是什么 两者区别
5 、xxx 的总结、历史回顾、社区评价
6 、下期技术 bbb 预告

[murmur]

现在的文章是，太细的往往涉及别人竞争力，人家不愿意跟你分享，那么能分享的应该是

1 、我用了 xxx 框架

2 、我用在 xxx 业务，运行时间 xxx 月，用户量或者并发 xxxx （拿来学习的真的不配吹，你自己都不敢上生产你怎么忽悠别人用）

3 、我投入了大概 xxx 人，对框架进行 xxx 级别的爆改 /调优 /监控

4 、我遇到了 xxx 问题，这个问题导致我用了 xxx 时间 /人力解决（可以不说怎么解决，但是一定要暴露严重性）

[tikazyq]

注意别在文章或标题中加以下关键字:
1. 面试
2. 涨薪
3. 万字
4. 吐血推荐
5. 初学者
6. 入门
7. 手撕
8. 必备
9. 详解
10. 如何

[locoz]

深入浅出，循序渐进，有实际场景作为例子。

很多人写技术文章是：“我碰到了一头大象，我要把大象塞进冰箱里，然后我这样这样再这样，大象就被塞进冰箱里了”。
但读者看的时候就会很懵逼，你说你“这样这样再这样”，但不说具体怎么样，我怎么知道是怎么样的？

[CODEWEA]

和营销号反着来

[Cbdy]

提供可以跑起来的实验代码 /demo

[Leigg]

你的问题暴露了你平时看的都是不怎么样的技术文章。可以多去搜罗一些大牛的技术文章，

[fengjianxinghun]

@murmur 还漏了一点，所有的数字 x10

[lecher]

draveness.me/whys-the-design/
安利一个篇篇经典的 blog

[kop1989]

我觉得怎么写一篇优秀的技术文章不好说。
但是如何写一篇及格的技术文章我觉得还是有章可循的，而且只有一点，无非必要，勿增实体。
我看很多技术文章，为了解释 A，引入一堆 BCDEF，结果还不解释 BCDEF 。

[coderluan]

听说过一句话吗, "同样是裸体, 有的是色情有的是艺术, 而他们并没有什么量化标准, AI 也都分不清, 但是男人一看就知道是哪种.", 技术文章也是一样的.

[xiaofan2]

@murmur 这个确实很重要
@dilu 这个说实话很多 肯定不是一篇文章能搞定的

@murmur 好方法

@tikazyq 哈哈哈哈都懂套路

@locoz 先场景再分析 再文后给代码怎样

@Leigg 那请问你平时看的都有哪些大牛的

[Leigg]

https://draveness.me/

[himself65]

那就是真的在说技术……

[doveyoung]

如果一份文档不能复制粘贴，那就毫无意义

[perpetually]

@murmur #1 在哪都能看到你，v 站轮子哥

[locoz]

@xiaofan2 #14 可以的。最好是在给代码的时候都一点一点来，说明白为什么要这么做，最后再放个完整代码到 GitHub 然后给个代码链接就行。

[asanelder]

@lecher #11
@Leigg #15 好东西

技术文章俺不太懂，太高大上了。

俺举一个写 leetcode 算法题解的例子吧。

在俺看来，刚上的很多关于 leetcode 的讲解，就是用中文把代码复述了一遍。其实这种俺认为不是真正的教会别人怎么去解。

好的文章应该是站在听者的角度，假设他什么也不知道，通过不断的引导与启发，来让他自己可以推导出来，最后他的感觉就是，是靠自己想出方案的。

关于这方面的东西，有一本书可以推荐给楼主看看

《怎样解题》（波利亚）

"这是一本关于如何求解数学题的书，但里面的方法和思路可以应用在其它方面" --《代码大全》推荐语