咖啡术语表只写英文全称不够：让新手读懂比例、对象和条件

读者看到“ratio 1:2”，不一定知道该倒多少水。这个比例可能谈的是干咖啡粉与杯中饮品，也可能来自另一份材料的用量表达。词汇表如果只写“ratio＝比例”，或者给出英文全称，问题仍留给读者猜。好的术语条目需要讲清比较的两个对象、单位、先后顺序和使用场景。

先把数字两边的对象补齐

教学示例：一份浓缩咖啡记录写“干粉20克，杯中饮品40克”。若定义为干粉质量与饮品质量之比，就可以写成1:2。这里的40克是杯中饮品，不是加入机器的水量，也不是40毫升；这个算例仅说明记法，不代表所有咖啡都应该按此配方制作。

另一份手冲配方可能使用干粉质量与加入水质量之比。两者分母对象不同，不能因为都出现“粉”和“比例”，就把一个数字换到另一张配方上。咖啡词汇表应在条目开头给出本页约定，遇到不同作者的记法，再明确提示读者查看原配方定义。

不要让一个词同时回答四个问题

一个条目先回答“是什么意思”，再分别处理“怎么记录”和“怎样使用”。例如，解释一项浓度指标，与判断一杯咖啡是否好喝是不同任务。某个数字可以用于记录与比较，却不能独自代表口味、原料质量或操作是否正确。

为条目加例子时，写出它成立的条件；为相近术语做交叉链接时，说明为什么容易混淆。若使用仪器读数，应核对仪器说明、取样方法和单位。没有查到可靠依据，就不附上看似权威的通用阈值，更不要把不同量纲的数字放在一起排名。

光算的术语条目语境与使用条件写法虽然以工业资料为例，但“全称之外还要解释当前含义”的方法也适合咖啡知识编辑。可以借用条目结构，不必把行业里的采购术语搬进冲煮教程。

给编辑一张简短的条目卡

• 标准写法与常见别名：读者可能从哪种写法进入。
• 当前语境：这次说的是原料、制作过程、杯中饮品还是设备。
• 一句解释：不依赖另一个没解释的专业词。
• 例子与反例：哪些记录可以比较，哪些不能。
• 来源与复核日期：定义、设备要求或计算式从哪里来。

条目不一定全部独立建页。只有一句普通解释的词，可以在教程中首次出现时说明；涉及多种对象、不同记法或常见误读，再安排完整条目。这样读者不必每隔一句就跳去另一页查词。

让一个新手复述下一步

审核时不要只问“你懂了吗”。给出一条示例记录，让对方指出哪个数字称的是干粉，哪个数字称的是饮品，比例怎样计算，是否能与另一份记录直接比较。如果他只能背出英文单词，说明条目还缺上下文。

之后修改定义时，把引用该条目的配方和培训讲义一起检查。术语统一首先是含义统一，大小写和排版只是最后一步。