如何在rdoc中显示常量的值？需展示值而非仅注释

好问题！默认情况下RDoc确实只会展示常量的注释内容，不会自动把常量的值也带上，但有两种实用的方案可以满足你的需求：

方法一：手动在注释中补充常量值（简单直接） #

这是最容易快速实现的方式，直接在常量的注释里明确写出它的值就行，比如：

# 系统允许的最大重试次数
# 值：5
MAX_RETRIES = 5

这种方式的优点是不需要额外配置，上手快；缺点是如果后续常量的值被修改，你得同步更新注释，否则文档会和实际代码不一致，适合常量值不常变动的场景。

方法二：自定义RDoc扩展自动提取常量值（自动化） #

如果你的项目里有大量常量，手动维护注释太麻烦，可以写一个简单的RDoc扩展，让它自动把常量的实际值追加到注释末尾，实现文档和代码的同步。

1. 首先创建一个扩展文件，比如命名为rdoc_constant_value_ext.rb，内容如下：

require 'rdoc'

# 重写RDoc的Constant类，自动为常量注释添加值
class RDoc::Constant
  def comment
    original_comment = super || ''
    # 避免重复添加值，检查注释里是否已有值的标记
    unless original_comment.include?('*值*:')
      "#{original_comment}\n\n*值*: `#{value}`"
    else
      original_comment
    end
  end
end

2. 生成文档时，通过-r参数加载这个扩展：

rdoc -r ./rdoc_constant_value_ext.rb path/to/your/ruby/code.rb

这样生成的文档里，每个常量的注释后面都会自动带上它的实际值，后续修改常量值时，重新生成文档就会自动同步，不用再手动更新注释。

注意：不同版本的RDoc可能API略有差异，如果上面的代码不生效，可以检查RDoc::Constant的可用属性——有些旧版本可能需要用@value代替value方法来获取常量值。

内容的提问来源于stack exchange，提问作者graywolf