2018-02-24 项目/教程中使用母语命名的"问题"

简介: 在教程中使用中文命名的一些副效应. Some side effects of naming identifiers in Chinese in the sample programs of tutorials.

早先试图找使用中文命名代码的项目, 但所获寥寥: 索引: 用中文编写代码的实用开源项目 · Issue #6 · program-in-chinese/overview. 更不用说教程了: 索引: 用中文代码作示例的编程教程 · Issue #5 · program-in-chinese/overview

前几天有幸看到Quora不久前的一个回复: Has any serious project been written in a non-English-based programming language?

得知西门子和爱立信内部都有使用母语命名的C/C++代码(德语/瑞典语). 原文如下:

At both Siemens (German) and Ericsson (Swedish), I have seen programs written in C, and C++ where the only English words are the keywords. So if, new, else, for and the standard libraries like std::vector<>

Everything else was in German or Swedish.
...

另外, 答者还提到在布拉格碰到过一本Java编程书, 也是用非英语进行命名写的示例代码.

以母语命名可读性强的优势, 照理说编程教程应该是非常适合这一实践的. 那么来试试:

enum 发薪日 {
    周一, 周二, 周三, 周四, 周五, 周六, 周日;

    private static final int 每班分钟数 = 8 * 60;

    int 发薪(int 工作分钟数, int 每分钟薪水) {
        int 底薪 = 工作分钟数 * 每分钟薪水;
        int 加班费;
        switch (this) {
        case 周六:
        case 周日: // 周末
            加班费 = 底薪 / 2;
            break;
        default: // 周中
            加班费 = 工作分钟数 <= 每班分钟数 ? 0 : (工作分钟数 - 每班分钟数) * 每分钟薪水 / 2;
        }
        return 底薪 + 加班费;
    }
}

观感如何? 个人觉得是非常一目了然, 但自带不少槽点.

下面看看原版(Effective Java第三版, Item 34的例程):

enum PayrollDay {
    MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY;

    private static final int MINS_PER_SHIFT = 8 * 60;

    int pay(int minutesWorked, int payRate) {
        int basePay = minutesWorked * payRate;
        int overtimePay;
        switch (this) {
        case SATURDAY:
        case SUNDAY: // Weekend
            overtimePay = basePay / 2;
            break;
        default: // Weekday
            overtimePay = minutesWorked <= MINS_PER_SHIFT ? 0 : (minutesWorked - MINS_PER_SHIFT) * payRate / 2;
        }
        return basePay + overtimePay;
    }
}

意思一样, 但是不是看上去有了些"距离感", 槽点似乎就没那么明显了, 尤其不会有太多代入感. 可以想见, 在翻译英文原著时, 译者对代码本身的命名进行中文化也许会吃力却讨不到多少好.

翻了也许会有其他麻烦的还有这种(同一本书, Item 68):

if (car.speed() > 2 * SPEED_LIMIT)    
    generateAudibleAlert("Watch out for cops!");

还有这种(Item 4):

String s = "bikini";

至于下面这个例子(Item 34), 问题是想翻译都只能找到音译词, 也许还不如不翻. 而且, 在示例代码里用"桔子", "苹果"之类在外文编程书籍中屡见不鲜, 但如果真用在中文代码中, 似乎第一感觉就有点幼稚.

public enum Apple  { FUJI, PIPPIN, GRANNY_SMITH }
public enum Orange { NAVEL, TEMPLE, BLOOD }

还有一种问题比如(Programming in Scala 第三版, 7.5节):

    val firstArg = if (args.length > 0) args(0) else ""
    firstArg match {
      case "salt" => println("pepper")
      case "chips" => println("salsa")
      case "eggs" => println("bacon")
      case _ => println("huh?")
    }   

直译过来是:

    val 参数1 = if (参数.length > 0) 参数(0) else ""
    参数1 match {
      case "盐" => println("胡椒")
      case "玉米薄片" => println("萨尔萨辣酱")
      case "鸡蛋" => println("培根")
      case _ => println("啥?")    
    }  

这几个词对于不大了解西方饮食习惯的读者来说, 读起来完全没有感觉. 与其费口舌在注解里普及西方文化, 也许改成这样更自然:

    val 参数1 = if (参数.length > 0) 参数(0) else ""
    参数1 match {
      case "牛奶" => println("面包")
      case "烧饼" => println("油条")
      case "煎饼果子" => println("薄脆")
      case _ => println("啥?")    
    }  

但这比起翻译本身来, 又多了不少工作量, 估计还很难获得原作者的同意. 当然, 如果是自编文献, 就没有原作的限制了, 但就像之前的例子所示, 恐怕选材和尺度都会比用英文代码更加敏感.

类似的, 在项目中使用中文命名也比英文命名更需要推敲. 随手写个奇怪的英文名看起来也许不那么显眼, 但用了中文, 就会非常扎眼. 所谓"文如其人", 也许语文的实用性会随着中文编程的推广而逐渐回归.

相关文章
|
2月前
|
开发者 iOS开发
【教程】修改应用程序开发者名称的步骤
【教程】修改应用程序开发者名称的步骤
|
2天前
|
XML 存储 数据格式
使用自定义模板和示例项目开发LabVIEW项目
使用自定义模板和示例项目开发LabVIEW项目
|
1月前
|
程序员 vr&ar
【虚幻引擎】DTProjectSettings 蓝图获取基本项目配置插件使用说明 获取项目命名,项目版本,公司名,公司识别名,主页,联系方式
本插件可以使用蓝图获取到项目的一些基本配置,如获取:公司名、公司识别名、版权声明、描述、主页、许可条款、隐私政策、项目ID、项目命名、项目版本、支持联系方式、项目显示标题、项目调试标题信息、应保留窗口宽高比、使用无边框窗口、以VR启动、允许窗口重设大小、允许关闭、允许最大化、允许最小化、虚假立体渲染设备的眼部偏移、视野用于虚假立体渲染设备。
41 0
【虚幻引擎】DTProjectSettings 蓝图获取基本项目配置插件使用说明 获取项目命名,项目版本,公司名,公司识别名,主页,联系方式
|
2月前
|
算法 开发者
【CMake 设计命名思路】自定义命令命名规范与风格指南
【CMake 设计命名思路】自定义命令命名规范与风格指南
43 0
|
7月前
|
存储 编译器 Shell
Makefile基础教程(变量的高级主题,变量的拓展)
Makefile基础教程(变量的高级主题,变量的拓展)
54 0
|
前端开发 JavaScript 算法
你真的会代码命名吗 ? 优雅学会《如来神掌》 再也不怕不知道如何命名啦!
你真的会代码命名吗 ? 优雅学会《如来神掌》 再也不怕不知道如何命名啦!
187 0
你真的会代码命名吗 ? 优雅学会《如来神掌》 再也不怕不知道如何命名啦!
|
缓存 Java fastjson
Java开发都需要参考的一份命名规范
好的命名能体现出代码的特征,含义或者是用途,让阅读者可以根据名称的含义快速厘清程序的脉络。不同语言中采用的命名形式大相径庭,Java中常用到的命名形式共有三种,既首字母大写的UpperCamelCase,首字母小写的lowerCamelCase以及全部大写的并用下划线分割单词的UPPERCAMELUNSER_SCORE。通常约定,类一般采用大驼峰命名,方法和局部变量使用小驼峰命名,而大写下划线命名通常是常量和枚举中使用。
Java开发都需要参考的一份命名规范
|
前端开发
前端工作总结264-命名报错
前端工作总结264-命名报错
52 0
libzip开发笔记(一):libzip库介绍、编译和工程模板
libzip开发笔记(一):libzip库介绍、编译和工程模板
libzip开发笔记(一):libzip库介绍、编译和工程模板
|
Java 应用服务中间件 C++
Java项目属性的配置解决方案
Java项目属性的配置解决方案
115 0
Java项目属性的配置解决方案