Ruby

傾向數組及雜湊的字面標記法(除非你需要傳遞參數到它們的建構函式中)。 # bad arr = Array.new hash = Hash.new # good arr = [] hash = {}    當你需要元素為單詞（沒有空格和特殊符號）的數組的時候總是使用 %w 的方式來定義字串數組。應用這條規則僅僅在兩個或多個數組。 # bad STATES = ['draft', 'open', 'closed'] # good STATES = %

單個異常使用 fail 關鍵字僅僅當捕獲一個異常並且反覆拋出這個異常(因為這裡你不是失敗，而是準確的並且故意拋出一個異常)。 begin fail 'Oops' rescue => error raise if error.message != 'Oops' end    不要為 fail/raise 指定準確的 RuntimeError。    # bad fail RuntimeError, 'message'

在 class 定義裡使用一致的結構。    class Person # extend and include go first extend SomeModule include AnotherModule # constants are next SOME_CONSTANT = 20 # afterwards we have attribute macros attr_reader :name # followed

    寫出自解釋文檔代碼，然後讓這部分歇息吧。這不是說著玩。    使用英文編寫注釋。    使用一個空格將注釋與符號隔開。    注釋超過一個單詞了，應句首大寫並使用標點符號。句號後使用 一個空格    避免多餘的注釋。 # bad counter += 1 # increments counter by

用英語命名標識符。   # bad - identifier using non-ascii characters заплата = 1_000 # bad - identifier is a Bulgarian word, written with Latin letters (instead of Cyrillic) zaplata = 1_000 # good salary = 1_000   

使用 :: 引用常量（包括類和模組）和構造器 (比如 Array() 或者 Nokogiri::HTML())。    永遠不要使用 :: 來調用方法。 # bad SomeClass::some_method some_object::some_method # good SomeClass.some_method some_object.some_method SomeModule::SomeClass::SOME_CONST

使用 UTF-8 作為源檔案編碼。    每個縮排層級使用兩個 spaces （又名軟 tabs）. 不要硬 tabs # bad - four spaces def some_method do_something end # good def some_method do_something end    使用 Unix-風格 分行符號。(*BSD/Solaris/Linux/OSX

rbenv 用來管理多個版本的 ruby 在使用者目錄的安裝和使用, 和 rvm 二選一使用. 具體區別 rbenv 的文檔裡有說明, 社區裡也有討論.系統需求OSX: 請找一個網好的地方, 從 app store 裡下載 xcode.app, 安裝完成後運行, 在設定中的 Downloads 裡安裝 Command Line Tools.Linux: 請安裝開發環境 (編譯連結工具和 ruby 的依賴), 如果只要 jruby 有 jre 就可以了.安裝 rbenv在 osx 上可以直接用

RVM 是一個命令列工具，可以提供一個便捷的多版本 Ruby 環境的管理和切換。https://rvm.io/如果你打算學習 Ruby / Rails, RVM 是必不可少的工具之一。這裡所有的命令都是再使用者權限下操作的，任何命令最好都不要用 sudo.RVM 安裝$ curl -L get.rvm.io | bash -s stable$ source ~/.bashrc$ source ~/.bash_profile修改 RVM 的 Ruby 安裝源到國內的

對於新入門的開發人員，如何安裝 Ruby, Ruby Gems 和 Rails 的運行環境可能會是個問題，本頁主要介紹如何用一條靠譜的路子快速安裝 Ruby 開發環境。次安裝方法同樣適用於產品環境！系統需求首先確定作業系統環境，不建議在 Windows 上面搞，所以你需要用:     Mac OS X     任意 Linux 發行版本(Ubuntu,CentOS, Redhat, ArchLinux ...)

實現 Markdown 文法和代碼文法高亮分別是用的 Redcarpet 和 pygments.rb 兩個 Gem：    https://github.com/vmg/redcarpet    https://github.com/tmm1/pygments.rb    https://github.com/richleland/pygments-css    http://

顯性等待： wait = Selenium::WebDriver::Wait.new(:timeout => 3)wait.until { driver.find_element(:id => "cheese").displayed? } 隱性等待： driver = Selenium::WebDriver.for :firefoxdriver.manage.timeouts.implicit_wait = 3 #

建立字串對象有多種途徑，最常用的可能是使用字串字面量（literals），即一組單引號或雙引號之間的字元序列。這兩種形式的區別在於，當構造字面量時，Ruby對字串所做處理的多少有所不同。Ruby對單引號串處理得很少。除了極少的一些例外。鍵入到字串字面量的內容就構成了這個字串的值。Ruby對雙引號字串有更多的處理。首先，它尋找以反斜線開始的序列，並用二進位值替換它們。其中最常見的是\n，它會被斷行符號分行符號替換掉。當一個包含斷行符號分行符號的字串輸出時，\n會強制換行。puts "And

Ruby的數組（arrays）和散列表（hashes）是被索引的收集（indexed collections）.兩者都儲存物件的集合，通過鍵（key）來訪問。數組的鍵是整數。而散列表支援以任何對象作為它的鍵。數組和散列表會按需調整大小來儲存新的元素。訪問數組元素是高效的，但是散列表提供了靈活性。任何具體的數組或散列表可以儲存不同類型的對象。使用數組字面量（array literal）--即方括弧之間放一組元素--可以建立和初始化新的數組對象。有了數組對象，在方括弧之間提供索引便可以訪問單個元素，

Regex的內建支援通常只限於指令碼語言如Ruby,Perl和awk等，這是一個恥辱：儘管Regex很神秘，但它是一個強大的文本處理工具。通過內建而不是通過程式庫介面來支援它，有很大的不同。Regex只是一種指定字元模式的方法，這個字元模式會在字串中進行匹配。在Ruby中，通常在斜線之間(/pattern/)編寫入模式（pattern）來建立Regex。同時，Ruby就是Ruby，Regex是對象並且可以當作對象來操作。比如，可以使用如下的Regex來編寫入模式，它會匹配包含Perl或Pytho

當你需要加入一個或多個動作至一個 RESTful 資源時（你真的需要嗎？），使用 member and collection 路由。 # 差 get 'subscriptions/:id/unsubscribe' resources :subscriptions # 好 resources :subscriptions do get 'unsubscribe', on: :member end # 差 get 'photos/search' resources

  避免無限迴圈的元編程。    寫一個函數庫時不要使核心類混亂（不要使用 monkey patch）。    代碼塊形式最好用於字串插值形式。        當你使用字串插值形式，總是提供 __FILE__ 和 __LINE__，使得你的回溯有意義。 class_eval 'def use_relative_model_naming?; true;

    需要插值與嵌入雙引號的單行字串使用 %() （是 %Q 的簡寫）。多行字串，最好用 heredocs 。 # bad (no interpolation needed) %(<div class="text">Some text</div>) # should be '<div class="text">Some text</div>' # bad (no double-quotes) %(This

    如果只是需要中尋找字串的 text, 不要使用Regex：string['text']    針對簡單的結構, 你可以直接使用string[/RE/]的方式來查詢. match = string[/regexp/] # get content of matched regexp first_group = string[/text(grp)/, 1] # get content of captured

優先使用 字串插值 來代替 字串串聯。 # bad email_with_name = user.name + ' <' + user.email + '>' # good email_with_name = "#{user.name} <#{user.email}>" # good email_with_name = format('%s <%s>', user.name, user.email)