程序员如何写好一篇技术文章?

2023-11-04

结合自身写作经历以及本次训练营直播分享的内容,谈一谈写作技巧以及程序员如何写好一篇技术文章。

1

写作训练营回顾

2020 年 12 月 26 日下午,我参加了一个写作训练营的直播,活动内容如下:

该训练营是以直播的方式开展,四位嘉宾给大家分享 IT 技术写作技巧、如何写出让人称赞的技术文章和技术写作心路历程,帮助坚持创作的作者们快速入门技术写作。

不仅仅是直播间,由于是平台组织的活动,相应的就有训练营微信交流群,很多朋友也都在群里。所以,不仅仅听到了各位大佬的分享,学到了掘金的内容分发策略,从三位老师这里收获到了很多经验和以前自己没有考虑到的点,也看到了各位朋友们的交流和观点上的碰撞。

因此本文是一篇观后感,文章标题是“程序员如何写好一篇技术文章”,我将结合直播内容、弹幕、交流群里的内容以及我的写作经历,来简单的谈一谈怎样写好一篇技术文章,主要的点会放在“写作技巧”“想要写好一篇技术文章比较重要的事情是什么”

2

“写作技巧”是长期写作经历的总结

直播的内容还是非常丰富的,包括各位大佬的写作技巧、写作方法论、时间安排、作者的写作生涯分享,有讲到“道”的部分,即方法论,也有讲“术”的部分,即具体的写作实践,还分别从读者和作者两个角度谈论了如何去写一篇受欢迎的文章,个人感觉看完直播还是收获到非常多。

不过交流群里和弹幕中也有一些其他的看法,比如有些朋友觉得收获满满,有人觉得看完没有收获,或者说与想象中的有偏差。我印象比较深的是大家对于“写作技巧”和“技巧干货”的看法,看直播的过程中就有朋友提出:“作者根本没有分享什么写作技巧啊”,或者“只听到写作方法论,没有具体的做法”等类似的观点。

对于这种观点我是不同意的,因为我从头到尾看了直播,直播中几位分享者确实分享了很多内容,不论是比较抽象的方法论还是具体的实践建议。

所以,在直播结束后,我就在思考以下几个问题:

  • 部分朋友是不是对于“写作技巧”过于偏执了?为什么在一味地追求写作技巧?

  • 究竟是想要“写作技巧”,还是想要从文章立意,到给文章取标题,再到写文章的每一个段落、每一行句子都得到手把手的指导呢?

  • 不止是这次训练营,在其他训练营或者交流群中也经常看到类似的说法。那么,某些朋友想要得到的“写作技巧究竟是什么?”

当然,我没有想到确切的答案,我只能通过我的写作经历给出一些我的个人看法:

不论是你听到或者看到的是什么技巧和经验,这些都是别人的,那技巧和经验又是怎么来的?是别人写作过程中和写作经历里总结出来的。

不知道你有没有看到其中的因果关系,有了经历才能总结出技巧和经验,引申到写作这件事情上,写作技巧是作者们长期写作和创作后的总结,千万不能本末倒置。如何获取写作技巧以及如何运用这些写作技巧,你要先去写啊,你一个字不写,别人说的再多,讲再多技巧,甚至坐在你电脑旁边看着你写,那你不写,能咋办?

给你再多的写作技巧,你用嘴巴写一篇文章?还是用脑袋写一篇文章?

用手啊!

写文章这件事可不讲究“君子动口不动手”,拿起笔或者敲键盘吧,打开编辑器,写一篇文章。

3

我的写作经历

2017 年 2 月,我开始在网上写文章、分享一下自己的想法还有自己的知识,但是菜鸟就是菜鸟,没有写作功底,没有技术沉淀,写出来的东西其实很乏味很枯燥,我第一篇文章,200 字左右,排版混乱,随便写了点内容。第二篇文章,200 字左右,排版依然非常混乱,内容很少。

不过我认定了一件事就要走到底,没人看就没人看,我还是要去写,别人不看我自己看,而且是刚开始写文章,写得好才有鬼了,有人看那更是做梦。

前路漫漫,别奢望太多,这种心态一直伴随着我。

一段文字简简单单的介绍完写作初期的经历,我知道大家也想听听当时遇到了哪些问题,因为在网上写博客并不是很简单的一个事情,起步阶段肯定会遇到各种各样无法解决的问题,比如下面这些:

  • 分享内容不确定,不知道该写什么

  • 写不出文章,100 个字都写不出来

  • 做不到周更,偶尔会很忙

  • 文章阅读量长期是个位数,很打击信心

  • 不知道自己能坚持多久

针对这些问题,我摸索出了一些方法。

从日常工作中找灵感、找题材,这样就渐渐的找到了要写的东西。

做不到周更就找个不忙的时间多写几篇,做出周更的样子。

憋不出来字,就去看书去学习,思考一下写作方法。

没人阅读虽然伤人,但是我知道自己是新人,有人读反而怪了,先默默的做吧,不断的写、不断地学习,别人有建议就认真的修改。就这样坚持了一年多,写了差不多 100 多篇与技术相关的文章,以上提到的那些问题都不存在了,虽然还是没什么流量,但是自己已经养成了写作的习惯,这是个非常好的习惯。

后来,开始写起了线上专栏,录制了视频课程,近期也在整理我的第一本书的底稿。

目前为止,我一共写了 400 篇左右的文章,做了 8 个文字类的付费专栏,还有 3 个视频课程。现阶段,我也在制作新的课程,手头上一个文字专栏更新和一本实体书的书稿整理,都是制作中的状态,同时也在极客时间上做了两个小分享,可以说这几年一直没有停下来过。

4

写作技巧总结

虽然,没有取得什么大成绩,但是四年下来也有一些关于写作技巧的总结,和本次写作训练营直播中的大佬总结的写作技巧也相差不大,无非是以下几点:

  • 多站在读者的角度去写文章,不要自说自话。

  • 少写水文,别做标题党,文章写得差,读者会反感。

  • 遵守各个社区的规定,不要乱写。

  • 平时多做笔记,积累写作素材。

  • 多看书,书里的知识更加系统化,质量更高。

  • 合理运用空闲时间,做好时间管理。

  • 自律,坚持。

肯定有人觉得这些内容虚头巴脑的,但是写作,确实就是这样,让我说别的技巧,并没有什么特别的技巧,就是坚持写,慢慢成长、慢慢进步。

5

写作之路,最重要的是行动和坚持

除了以上写作技巧之外,我觉得想要写好一篇技术文章最重要的两件事情是:

  • 打开编辑器写文章,你要行动起来啊!

  • 坚持写文章,不一定非要一周写一篇或者三天写一篇文章,但是如果你想要尝试写作的道路,你就要坚持利用空余的时间去写作。

这两点才是最重要的,写 + 坚持写,不然你听到那么多写作技巧、学那么多写作技巧,没有用武之地啊。

网易云时间到!

懂得了很多道理,却依然过不好这一生。

实践才是检验真理的唯一途径,最重要的是去写文章,写作技巧可以慢慢学、慢慢理解。

去各个博客平台,注册账号,点击发布文章,进入编辑器,写文章,然后发布。

CSDN 发布文章:

博客园发布文章:

掘金发布文章:

当然,还有公众号、思否、开源中国、知乎等等内容平台,都可以写文章,这里只截了三张图。

6

踏上你的写作之路,行动吧!

想把文章写好,你要先去写,我是这样,其他作者也都是这样,刚开始哪有什么技巧可讲呢。写完之后,自己看两遍,发给朋友看两遍,然后找找问题,改改不对的地方。如果是自己都看不下去的文章,发到网上,别人和你的想法也类似,那就是不想看。

坚持写,及时改正错误并优化文章,这是最基本的要求。至于阅读量多少、文章能不能火,这个就看文章质量高不高了。文章写的好,就不完全不用担心,文章写的不好,就花心思好好改。

刚开始写,不要太在意技巧之类的,先认认真真写几篇文章。

文章没写几篇,天天想着写作技巧,虽然思路没错,但是太刻意了。技巧是一步一步,一点一点积累出来的,不是别人说了,你就能吸收的。所以,建议各位作者沉下心来,多写多分享,找到适合自己的文章方向,打磨出自己的写作技巧,早日成为大 V。

● 开源啦!一个基于 Vue 3 + Vant 3 的商城项目

● Vue3实战系列:Vue3.0 + Vant3.0 搭建种子项目

● 程序员的副业:我靠写作赚到的第一笔收入

● Vue+Spring Boot 前后端分离的商城项目开源啦!

● 「2020年中总结」这半年我又做了哪些副业?

● 我在地铁上写了一个开源商城项目

● 开源项目在闲鱼、b 站上被倒卖?这是什么骚操作

● 年终总结-2019年,我的副业元年

● 程序员,你怎么这么忙

● 捅娄子了,写个bug被国家信息安全漏洞共享平台抓到了

● SpringBoot+MyBatis开发JavaWeb线上商城项目

“程序员的小故事”公众号中除注明转载/出处外,皆为作者原创,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文链接,否则保留追究法律责任的权利。

本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)

程序员如何写好一篇技术文章? 的相关文章

随机推荐

  • IDEA 总是提示登录github,登陆后不能push的解决办法

    运行环境 IDEA版本 2020 2 3 Windows 10 git 版本 2 29 2 问题描述 每次push到github时都提示登录 如下图 然而 用命令行push是成功的 此方法适用的前提是能从命令行登录 IDEA的File Se
  • 1. XAML简单的划分区域

    1 运行效果 2 XAML程序
  • QT信号与槽的特点和用法

    1 概念 信号 Signal 就是在特定情况下被发射的事件 例如 PushButton 最常见的信号就是鼠标单 击时发射的 clicked 信号 槽 Slot 就是对信号响应的函数 槽就是一个函数 与一般的 C 函数是一样的 可以定义在类的
  • nested exception is org.apache.ibatis.binding.BindingException

    nested exception is org apache ibatis binding BindingException Parameter roleIdList not found Available parameters are 0
  • Date转换成LocalDateTime类型

    1 先new 一个当前时间 2 获取instant和zoneId 3 将instant和zoneId塞进LocalDateTime ofInstant这个方法里面 4大功告成 我也是今天碰到记录一下 省的以后在找
  • 生信学习——基于R的可视化习题30个(附详细答案解读)

    题目目录 一 基础绘图 1 对RNAseq expr的每一列绘制boxplot图 2 对RNAseq expr的每一列绘制density图 3 对RNAseq expr的每一列绘制条形图 4 对RNAseq expr的每一列取log2后重新
  • Qt串口调试助手

    串口通信因为其协议简单 应用灵活 被广泛使用 Qt自带了串口通信模块QtSerialPort 功能齐全 使用起来非常方便 QtSerialPort模块中有2个类使用的最多 分别是QSerialPort类和QSerialPortInfo类 Q
  • selenium-server-standalone.jar无法启动

    java jar selenium server standalone 2 48 0 jar htmlSuite firefox http localhost 8080 F selenium selenium 2 41 0 login su
  • idea默认文件类型关联

    idea在文件创建的时候没有指定后缀或关联成文本 解决 Editor gt File Types gt Text
  • 【YOLOv8/YOLOv7/YOLOv5/YOLOv4/Faster-rcnn系列算法改进NO.64】即插即用新的注意力机制RFAConv

    前言 作为当前先进的深度学习目标检测算法YOLOv8 已经集合了大量的trick 但是还是有提高和改进的空间 针对具体应用场景下的检测难点 可以不同的改进方法 此后的系列文章 将重点对YOLOv8的如何改进进行详细的介绍 目的是为了给那些搞
  • [译] LLVM IR中间码指令集

    最近在研究这个东西 实在百度不到 最后在谷歌上找到英文手册 英文手册地址 https llvm org docs LangRef html 先说点废话 国内的IT水平离世界顶级水平差距实在有点大 个人感觉 有些因素导致这个结果 1 化身广告
  • 控制工程学习2

    前言 此文为个人学习笔记 所学习的视频链接 1 https www bilibili com video BV1hV411v7KB p 29 share source copy web 2 https www bilibili com vi
  • 快速实现Lora通信(一对多)详解

    TOC 一 Lora介绍 Lora不是一种协议 而是一种基于扩频通信的射频技术 它相对于其他射频技术比如2 4G或普通433 915M来讲 具有更远的传输距离 几千米 和更强的越障性能 所以我们把一个Lora设备作为中心点 多个Lora设备
  • https://www.cnblogs.com/wenwenli/p/8301975.html

    https www cnblogs com wenwenli p 8301975 html 单线程 单进程 非阻塞 事件驱动 句柄就是函数 事件驱动模型 事件源 触发事件 监听事件程序 事件处理程序 路径的要求不严格 node的知识点 1
  • 使用 WSL 在 Windows 上安装 Linux 编程

    使用 WSL 在 Windows 上安装 Linux 编程 近年来 随着开源软件的盛行和跨平台开发的需求不断增长 Windows Subsystem for Linux WSL 成为了一个备受瞩目的工具 WSL 允许我们在 Windows
  • pycharm设置中文,字体颜色修改,设置背景图片(图文讲解)

    目录 1 设置中文 2 设置背景图片 3 字体大小 颜色的修改 这个是我的pycharm编译器的样子 好看吧 pycharm在安装之后默认是英语的 有些小伙伴的英语不太会 看英文会比较吃力 这里我来教大家怎么去设置中文 以及字体颜色大小 背
  • 客户端client 突然断电了,那么服务器如何快速的知道呢

    1 使用定时器 适合有数据流动的情况 2 使用socket选项SO KEEPALIVE 适合没有数据流动的情况 心跳包技术 心跳包之所以叫心跳包是因为 它像心跳一样每隔固定时间发一次 以此来告诉服务器 这个客户端还活着 事实上这是为了保持长
  • elementui el-tree多层级数据递归根据条件筛选(禁用指定节点)

    项目中用的是elementui的tree组件 要实现的效果是根据关键字去筛选过滤出禁用的节点 所以首先需要的是对树结构数据进行整合 export function deepFilter3 nodes key query Array isAr
  • Android WebView 的使用

    WebView webView WebView findViewById R id webView webView loadUrl http 192 168 1 3 8080 action stream webView setWebView
  • 程序员如何写好一篇技术文章?

    结合自身写作经历以及本次训练营直播分享的内容 谈一谈写作技巧以及程序员如何写好一篇技术文章 1 写作训练营回顾 2020 年 12 月 26 日下午 我参加了一个写作训练营的直播 活动内容如下 该训练营是以直播的方式开展 四位嘉宾给大家分享