vagrant - 是否有在 Vagrantfiles 中引用变量的样式指南？

Question

当我查看 Vagrant 文档时 https://www.vagrantup.com/docs/networking/forwarded_ports.html它给出了一个这样的例子:

Vagrant.configure("2") do |config|
  config.vm.network "forwarded_port", guest: 2003, host: 12003, protocol: "tcp"
  config.vm.network "forwarded_port", guest: 2003, host: 12003, protocol: "udp"
end

但是，以下内容似乎也是有效的:

单引号

Vagrant.configure("2") do |config|
  config.vm.network 'forwarded_port', guest: 2003, host: 12003, protocol: "tcp"
  config.vm.network 'forwarded_port', guest: 2003, host: 12003, protocol: "udp"
end

冒号前缀

Vagrant.configure("2") do |config|
  config.vm.network :forwarded_port, guest: 2003, host: 12003, protocol: "tcp"
  config.vm.network :forwarded_port, guest: 2003, host: 12003, protocol: "udp"
end

这些语法有什么区别？仅当有变量时才应使用双引号 like in puppet ？

冒号前缀语法是什么？这很令人困惑，因为该行的其余关键字都有冒号后缀。

有 Vagranfiles 的风格指南吗？

Answer 1

免责声明:以下内容是个人观点(只是我对此的看法)。但所有的风格指南也是如此。不要陷入太深的思考背后的原因，只需做出你的选择并尽量保持一致。

有 Vagrantfiles 风格指南吗？

简短:Use this style guide

长答案:似乎没有任何官方的 Vagrant 风格指南，但由于它是 Ruby 编程语言，我们可以看一下官方的 Ruby 风格指南...哦，等等，实际上 Ruby 也没有!这可能是最受欢迎的，所以坚持下去:

rubocop-hq/ruby-style-guide

我应该使用什么:单引号('word')、双引号("word")或符号(:word) ？

简单地说:使用双引号。

长答案:风格指南在单引号和双引号问题上是矛盾的:it offers you choice A and B ，所以坚持使用 Vagrant 文档:

• 默认使用双引号:

  node.vm.provision“shell”，内联:“从节点 #{i} 回显 hello”

• 如果双引号是字符串的一部分，请使用单引号。这个snippet from Vagrant documentation与 style guide 一致:

  config.winssh.export_command_template = '$env:%ENV_KEY%="%ENV_VALUE%"'

冒号前缀语法是什么？

简而言之:冒号标记一个符号 ( see Ruby documentation )。

这个答案再展开一点:What is the colon operator in Ruby?

什么时候应该在 Vagrantfile 中使用symbols？

简单地说:(实际上)从来没有。

长答案:只要坚持使用双引号即可保持一致性，除非您在 Vagrant 解析 Vagrantfile 时遇到可变性或性能问题。有关 Ruby 中符号和字符串的性能和可变性的更多信息:The Difference Between Ruby Symbols and Strings .