Technical note

Hello Blog:一些工程记录的起点

这是一篇关于为什么开始整理个人技术博客的说明,也记录这个博客后续会关注的方向:C++、CAD/CAE、OCCT、OSG、Qt、几何算法、显示引擎和真实工程经验。


为什么开始写这个博客

这个博客是我给自己留的一块长期记录空间。

过去一段时间里,我主要在做工业软件、CAD/CAE、几何建模和三维显示相关的工作。很多问题在当时看起来只是一个 bug、一次性能优化、一次接口迁移,或者一次源码阅读。但真正做完以后回头看,会发现里面有不少值得留下来的东西:

  • 问题最开始是怎么出现的;
  • 当时为什么会走到某个错误方向;
  • 后来是怎么定位到核心原因的;
  • 最后形成了什么工程判断;
  • 还有哪些地方其实只是阶段性取舍。

这些内容如果只留在聊天记录、临时文档、提交信息或者脑子里,很快就会散掉。过一段时间再回头看,可能只记得“这个问题以前处理过”,但具体怎么分析、为什么这么改、哪些方案被放弃过,就很难还原了。

所以我想把这些内容逐步整理成文章。不是为了包装项目成果,而是希望以后自己再遇到类似问题时,有一份能看懂的工程记录。

这个博客主要写什么

这个博客会主要关注我平时工作和学习中真正接触到的技术方向:

  • C++ 工程实践;
  • CAD/CAE 前处理相关问题;
  • OCCT 源码阅读和几何算法;
  • OSG、Qt 和三维显示引擎;
  • 拾取、高亮、显示隐藏、局部重建等交互与渲染问题;
  • 几何修复、布尔运算、压印和共形处理;
  • 工具链、构建、调试和跨平台问题;
  • 工程架构、性能优化和项目复盘。

这些问题很多时候不是看一个 API 文档就能解决的,更多需要结合源码、日志、模型数据、业务约束和历史代码一起判断。

我希望这里的文章能尽量保留这种真实过程,而不是只写最后的“正确答案”。

我希望怎么写

这个博客不会追求很强的包装感。

我更想写清楚的是:

问题是什么;
我一开始怎么理解;
中间走过哪些弯路;
后来为什么改变判断;
最终方案解决了什么;
还有什么没有解决。

有些文章会像源码分析,有些更像问题排查记录,也有些只是学习笔记或阶段复盘。它们不一定都有完整结论,也不一定每一篇都能沉淀成通用方法。

但我希望至少做到两点。

第一,文章要能被未来的自己看懂。不能只留下结论,而不交代当时的上下文。

第二,文章要尽量克制。能确定的地方就写清楚,不确定的地方就说明还需要验证。工程里的很多判断都和具体模型、版本、数据规模、历史架构有关,没有必要把一次局部经验写成绝对结论。

关于公开发布

这里的内容会尽量做脱敏处理。

涉及内部项目名、客户信息、真实路径、账号、日志原文、未公开业务目标、具体模型来源等内容时,我会尽量改成更通用的描述,例如“一个显示引擎迁移项目”“某个飞机模型”。

如果某些数据来自具体实验,我会尽量说明它只代表当前模型、当前版本和当前参数下的结果,不把局部结论写成通用承诺。

对我来说,这个博客不是一个展示页,更像一个长期维护的工程笔记库。

如果几年后回头看,里面还能找到一些当时真实思考过的问题、踩过的坑和形成过的判断,那它就有价值。