Ruby 从来没有规定过文件的命名方式啊 这个本来就是 Best Practice 啊 当然你可以违背那没有问题，只是人家会觉得你的代码不专业而已。。

#1 楼 @iBachue 我不认为 Gems 上提供的是 Best Practice，不然我就不会提这个问题了

#2 楼 @jamchange Ruby 和 Gems 是两码事 Gems 确实提供了一定的约束（但不是很强制的约束）Ruby 完全不管。。

#3 楼 @iBachue 。。。我明白。 这里有两点：

• Ruby 的很多 stdlib 命名很不一致，不按套路出牌啊
• 所以我找找业内推荐的 rb 文件命名规范，找到了 rubygems 上的。但它的这种方式在命名一个名称含下划线函数 rb 文件时，会导致混淆。所以我觉得相比 JAVA 式的文件命名，它不是一个 Best Practice。。所以来这里问大家，让大家推荐一个更好的 solution、真正的 Best Practice

#4 楼 @jamchange 没听说什么语言的 stdlib 总是按套路出牌的 Java 标准库不是更加混乱吗？ 在大部分情况下 我们不会把单独一个函数写在一个文件里 而是写在类里或是模块里。

#5 楼 @iBachue 我说的命名很不一致 是指文件命名和类名不一致啊，上面那些例子都在那。JAVA 根本不可能出现这种情况的。

比如，有个 util 方法是 Foo::Utils.say_hello

module Foo
  module Utils
      def self.say_hello
        puts "Hello"
      end
  end
end

按 Gems 的规范，推荐文件名是"foo/utils/say_hello.rb"，但你看这文件名，很容易会以为是 Foo::Utils::SayHello 这个类

明白了不？

PS：我感觉我最近在 RubyChina 的帖子，回复的都不对题啊，都不理解我在说什么啊啊啊啊。是我表达能力有问题吗？还是我表达的太跳跃了？

#6 楼 @jamchange "foo/utils.rb"

不必纠结细节，ruby 本来就跟 java 不一样啊，一个文件可以放好几个类，这跟 java 是不一样的，怎么能用 java 的机制呢

#7 楼 @Rei 倒好。不过要是函数要拆开写，不全放到一个 utils.rb 里呢？是不是大家都避免出现这种情况？

#8 楼 @huaoguo 。。。。

我是在找一个规范了解了解，写写简单的脚本当然不要考虑这些问题，但针对大的项目，总要规范下 rb 文件命名的吧

#9 楼 @jamchange 是的，我的意思已经很明确了，"foo/utils.rb"才是标准写法 对于函数拆开写的行为 我们通常会做子模块的 随随便便把类分在几个文件里不是好的 practice。

#11 楼 @iBachue 明白了。不过你又没仔细看哦。这里举的例子不是用于 include 的实例方法，而是单独的工具函数，通过 Foo::Utils.say_hello 调用。

#9 楼 @jamchange

# foo/utils.rb
require 'foo/utils/sub'

module Foo
  module Utils
    extend Sub

    def self.say_hello
      puts 'Hello'
    end
  end
end

# foo/utils/sub.rb
module Foo
  module Utils
    module Sub
      def sub_method
        puts 'Sub method'
      end
    end
  end
end

#10 楼 @jamchange 简单地说，就用 RubyGems 的规范。Ruby 虽然解决问题的方法不止一个，但是这类规范是很统一的。

#13 楼 @Rei 明白。谢谢。不过如果使用文件名与 module 名一致的方式，我觉得恐怕也不必这样用 extend 了。另外对于 @iBachue 提到的不随便把类的方法拆成多个文件定义的，其实在 Ruby 中也挺常见的啊，有时需要重新 open 一个 class 再添些方法。连 C# 这样的语言都有 partial class，说明这种特性还是有需求的

#12 楼 @jamchange 同 13 楼 其实你平时随便看看 railties，actionpack 和 activerecord 的代码就知道什么才是 Ruby Way 了，这方面的实践，世人早有定论。

另外对于 @iBachue 提到的不随便把类的方法拆成多个文件定义的，其实在 Ruby 中也挺常见的啊，有时需要重新 open 一个 class 再添些方法。连 C# 这样的语言都有 partial class，说明这种特性还是有需求的

特性本身是很常用啦，但是这招通常用于 Hack 别人的代码，如果代码从头到尾都是自己写的，这种方法都不是很常用了，当然偶尔出于什么特别目的也是有可能的。

#16 楼 @iBachue Ruby 的 stdlib 可不是个好榜样

#17 楼 @jamchange 是啊 看 Rails 的源代码吧

#18 楼 @iBachue 看了。

看这个 to_json 方法扩展。 https://github.com/rails/rails/blob/master/activesupport/lib/active_support/core_ext/object/to_json.rb

总有情形会遇到 rb 文件以方法名称命名的。对于这种情形也没啥规范，就看这个 method name 的人品能不能一读就知道是方法名了

#18 楼 @iBachue 我没怎么用过 Rails，不知道你们平时有没有这样用过

require 'active_support/json/encoding'
ActiveSupport::JSON.encode(obj)  # 目的为了用一个encoding.rb中定义的encode方法

require 和 java/python 里的 import 不是一回事，你可以 import 一个类，一个函数，但 require 的是文件...

ostruct 和 fileutils 是历史原因，但除了楼主也没有几个人感到困惑或不便...

如果规定了一个文件能且只能定义一个类，那么文件名和类名一致就可以了。这个规定也就在类非常多的时候有用... 但不是人人都在写这种包含成白上千个类的面条代码的。

#19 楼 @jamchange 其实这个有经验的人一看就明白了 core ext 类是 object，方法就是 to_json 了。。 #20 楼 @jamchange 其实里面有个 module 叫ActiveSupport::JSON::Encoding...

虽然看到大神们争辩，实在是不敢插嘴，但是实在没忍住说一句： 规定少了嫌没规范； 规矩多了怕束缚。

这是一种什么心态呀！