2. 光学设计文件基础

说实话,我见过太多因为文件命名混乱导致的悲剧了。

有一次,一个同事把优化了三个星期的镜头设计文件存成了“最终版_真的不改了_v3.zmx”。结果第二天,他又改了一版,存成了“最终版_真的不改了_v3_最终版.zmx”。你猜后来发生了什么?他拿着旧版去投了模具,开模费花了八万,才发现光路不对。

嗯,从那以后,我们团队就立下了死规矩——文件命名必须统一,谁乱起名谁请客。

2.1 项目文件夹结构:从根到叶的规范

我个人习惯,项目文件夹从顶层就要清晰。一个光学设计项目,通常包含设计源文件、分析数据、工艺文档、会议记录这几大类。

下面这个结构,是我在多个项目中打磨出来的,你可以直接拿去用:

Project_2024_OM_AL_001/
├── 00_Reference/          # 参考文档、竞品分析
├── 01_Design_Source/      # 设计源文件(Zemax/CodeV等)
│   ├── 01_Initial/        # 初始架构
│   ├── 02_Optimization/   # 优化过程
│   └── 03_Final/          # 最终定稿
├── 02_Analysis/           # 像质评价、公差分析
├── 03_Drawing/            # 二维图纸、三维模型
├── 04_Reports/            # 设计报告、评审纪要
└── 05_Manufacturing/      # 加工文件、检测数据
我的小技巧: 文件夹编号用两位数字(01、02...),这样排序永远不会乱。我见过有人用1、2、3,结果到了10,排序就变成了1、10、11、2... 你想想看,那得多崩溃。

2.2 项目文件夹命名规则

项目文件夹的命名,我建议采用“三段式”结构:

字段 含义 示例
项目年份 四位年份,如2024 2024
项目类型 两位字母缩写 OM(光学镜头)、IL(照明)、LA(激光)
项目编号 三位流水号 001、002

举个例子:2024_OM_AL_001 表示“2024年光学镜头项目,安防类,第1个”。

项目类型缩写对照表(我常用的):

  • OM — 光学镜头(Optical Module)
  • IL — 照明光学(Illumination)
  • LA — 激光光学(Laser Application)
  • AR — 增强现实(Augmented Reality)
  • AL — 安防镜头(AI Lens / Security)

2.3 设计文件命名:一眼看懂是什么

设计文件的命名,说白了就是要做到“不看文件夹,也知道这是哪一版”。

我建议的格式是:

[项目简称]_[镜头类型]_[视场角]_[版本号].[扩展名]

比如:

  • OM_AL_120_FOV_v1.0.zmx — 安防镜头,120度视场角,版本1.0
  • OM_AL_120_FOV_v1.1.zmx — 同上,小改版
  • OM_AL_120_FOV_v2.0.zmx — 大改版,架构变了
千万别这么干:
  • ❌ 最终版.zmx — 没有“最终”,只有“最后一版”
  • ❌ 改改改_v3.zmx — 谁改的?改了啥?
  • ❌ test_2024_03_15_晚上加班版.zmx — 太随意了

2.4 版本号命名规则:语义化版本

版本号我强烈推荐用“语义化版本”规则,也就是 主版本.次版本.修订号。

版本号 含义 什么时候用
v1.0.0 初始发布 第一个可评审的版本
v1.1.0 功能改进 优化了像质、调整了镜片
v1.1.1 小修小补 改了公差、更新了玻璃库
v2.0.0 重大变更 架构重做、视场角变了
避坑指南: 我曾经遇到过版本号从v1.0直接跳到v10.0的情况,中间发生了什么完全不知道。所以,每次改版都要写版本变更说明,哪怕只写一行字。

2.5 版本号与文件名的组合示例

下面是我在实际项目中的一个完整示例,你可以参考:

Project_2024_OM_AL_001/
├── 01_Design_Source/
│   ├── 01_Initial/
│   │   └── OM_AL_120_FOV_v0.1.zmx   # 初始架构探索
│   ├── 02_Optimization/
│   │   ├── OM_AL_120_FOV_v0.5.zmx   # 优化中
│   │   └── OM_AL_120_FOV_v0.8.zmx   # 接近目标
│   └── 03_Final/
│       ├── OM_AL_120_FOV_v1.0.zmx   # 评审通过版
│       ├── OM_AL_120_FOV_v1.1.zmx   # 微调后
│       └── OM_AL_120_FOV_v2.0.zmx   # 架构变更版

2.6 版本号管理流程图

下面这张图,是我自己总结的版本号管理流程。说白了,就是告诉你什么时候该升主版本,什么时候改次版本。

版本号管理流程图 初始版本 v0.1 是否通过评审? 是 否 发布 v1.0.0 继续优化 v0.x 后续变更类型? v1.0.1 小修小补 v1.1.0 功能改进 v2.0.0 架构重做 说明:主版本(架构变更)→ 次版本(功能改进)→ 修订号(小修小补)

2.7 避坑指南:我踩过的那些坑

最后,分享几个我亲身经历过的教训:

  • 别用“最终版” — 我见过一个项目,文件夹里有“最终版”、“最终版2”、“最终版3”、“打死也不改了版”。最后谁都不知道哪个是真的。
  • 版本号别跳 — 从v1.0直接跳到v3.0,中间发生了什么?没人知道。每次改版都要有记录。
  • 文件名别带空格 — 有些软件对空格敏感,用下划线代替。比如 OM_AL_120_FOV_v1.0.zmx 而不是 OM AL 120 FOV v1.0.zmx。
  • 日期格式统一 — 如果文件名里要加日期,用 YYYYMMDD 格式,比如 20240315。别用 03-15-2024 或 15/03/2024,排序会乱。

总结一下: 文件命名规范不是形式主义,它是团队协作的基石。你想想看,一个项目做半年,文件上百个,如果没有统一的命名规则,找文件的时间可能比设计的时间还长。

我个人习惯,每次新建项目,第一件事就是建好文件夹结构,然后发到团队群里。大家按这个规则来,谁也别搞特殊。