先懂，后写
不以复制粘贴代替理解。在引入工具之前，先弄清问题的边界、 数据的流向、失败的方式，以及真正需要承担的代价。
ANCIENT CODECRAFT · VOL. 01
DIGITAL HERITAGE KEEPER
古法编程 非遗继承人
在快速迭代的洪流里，
我仍相信一行明白的代码，
胜过一座无人维护的云端楼阁。
不追逐新潮，
只打磨经得起岁月的程序。
我是古法编程的实践者。所谓古法，并非拒绝新技术，
而是尊重技术最朴素的规律：结构应当清晰，依赖应当克制，
数据应当可控，系统应当能够被后来的人读懂。
我写下的不是一次性的功能，而是一份可以传递的手艺。
如同木匠识木纹、匠人守榫卯，程序员也应理解每一层抽象背后的来处。
不把复杂藏进黑盒，不把问题交给“以后再说”，
每一次设计都尽可能让逻辑、边界与责任清楚可见。
三条祖传规矩
这些规矩不保证每个项目立刻显得“先进”， 但能让系统在需求变化、人员更替和时间流逝之后，依然保持可理解、可修改、可修复。
少即是多
能用一个文件解决的事，不轻易拆成十个服务。 能不增加依赖，就不为项目添一份未来的负担。
留有余地
为异常留出分支，为维护写下说明，为数据留下备份。 给未来的自己和同伴，留下一盏可以循路回来的灯。
从“能跑”到“能传”
第一年 · 初识代码
从一台旧电脑开始
第一次让屏幕输出一行文字时，便意识到程序不是遥不可及的技术， 而是一种与机器沟通的语言。那时写下的每个 if、for 和 function， 都像第一次学会使用刻刀的学徒。
第三年 · 走入工程
见识复杂，也见识代价
经历过依赖层层嵌套、配置无人敢改、服务拆得过细却无人能维护的系统。 也因此理解：真正的复杂不是代码行数多，而是没人知道它为什么存在。
第六年 · 回归基本功
开始相信朴素方案
重新重视数据结构、网络协议、操作系统、数据库和语言本身。 在许多场景中，可靠的基础能力比新潮的包装更能解决问题。
至今 · 守艺与传艺
让代码成为可继承的技艺
持续实践“小而清楚”的系统设计，记录工程决策， 分享基础原理与长期维护经验。愿后来写代码的人， 不只会调用工具，也拥有理解工具的能力。
守的是基本功，做的是现代工程
01 / WEB CRAFT
原生 Web 构建
优先理解浏览器、HTML 语义、CSS 布局与 JavaScript 运行机制， 在需要时再选择合适框架，而不是让框架替代思考。
HTML · CSS · JavaScript · Web API
02 / SYSTEM DESIGN
系统架构与边界
重视模块职责、数据边界、接口契约与故障处理。 系统不是图纸上的方块，而是长期运行中每一次真实协作。
API · Database · Cache · Queue · Domain
03 / DATA STEWARDSHIP
数据与持久化
数据是系统最珍贵的资产。重视建模、索引、备份、迁移、 一致性和恢复能力，不让业务记忆消失在一次错误操作中。
SQL · PostgreSQL · MySQL · Redis · Backup
04 / AI WITH JUDGMENT
AI 协作式开发
使用 AI 加速检索、推演、测试和重复劳动， 但始终由人负责需求判断、架构取舍、安全边界与最终质量。
LLM · RAG · Agent · Evaluation · Guardrails
一些正在被认真维护的事
ARCHIVE / 001
LOCAL FIRST
LOCAL FIRST
个人知识库与数字手稿
一个优先本地存储、可全文检索、可长期导出的知识记录系统。 不让思想被某个平台绑定，不让多年笔记因为产品停运而失去归处。
ARCHIVE / 002
MINIMAL WEB
MINIMAL WEB
无框架静态站点实验
探索如何只用 HTML、CSS 与少量 JavaScript 构建快速、优雅、 低能耗且容易迁移的网站。页面应当服务内容，而非要求用户等待。
ARCHIVE / 003
CODE READING
CODE READING
旧系统修复与代码考古
为无人维护的历史项目补充文档、梳理依赖、恢复构建流程， 让那些看似“过时”的系统重新变得可理解、可部署、可交接。
一段足以传世的代码
/ * CODE IS A CRAFT, NOT A SPELL. * /
// 不炫技，不失语；不盲从，不停学。
function writeCode(问题) {
const 理解 = 深入(问题);
const 边界 = 明确(理解);
const 方案 = 保持简单(边界);
if (后来者能够读懂(方案) && 可以长期维护(方案)) {
return 沉稳地实现(方案);
}
return 重新思考("复杂从何而来");
}
// 愿每一次提交，皆有来路，亦有归处。善用新器，不失旧法
工具应当放大判断，
而非取代判断。
而非取代判断。
我不反对框架、云服务、低代码和人工智能。 它们都是这个时代重要的生产力。 但一把锋利的刀，仍然需要知道该由谁握、该向哪里落下。
- 使用 AI 辅助编写代码，但不把未经理解的结果直接投入生产。
- 使用框架提升效率，但先理解其解决的问题与隐藏的约束。
- 使用云服务降低运维成本，但始终准备好数据备份与迁移方案。
- 使用自动化减少重复劳动，但保留关键流程的人工可控能力。
- 拥抱新技术，但不因“流行”而放弃对稳定性的尊重。
传
愿你写下的每一行代码，
都经得起时间的编译。
技术会更新，框架会更替，产品会消失。
但清晰的思想、可靠的设计与诚实的工程精神，应当被一直传承下去。
书信往来：
flcoder@163.com