Ruby On Rails项目启动报错：RUBYOPT含无效开关-F

报错信息 #

Fetching gem metadata from https://rubygems.org/...........
Resolving dependencies...
Bundle complete! 14 Gemfile dependencies, 83 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.
         run  bundle lock --add-platform=x86_64-linux
Fetching gem metadata from https://rubygems.org/.........
Resolving dependencies...
Writing lockfile to C:/laragon/www/project/Gemfile.lock
         run  bundle binstubs bundler
       rails  importmap:install
C:\Ruby32-x64\bin\ruby.exe: invalid switch in RUBYOPT: -F (RuntimeError)
       rails  turbo:install stimulus:install
You must either be running with node (package.json) or importmap-rails (config/importmap.rb) to use this gem.
You must either be running with node (package.json) or importmap-rails (config/importmap.rb) to use this gem.

Gem环境信息 #

C:\Users\Javier Franco>gem env
RubyGems Environment:
  - RUBYGEMS VERSION: 3.4.10
  - RUBY VERSION: 3.2.2 (2023-03-30 patchlevel 53) [x64-mingw-ucrt]
  - INSTALLATION DIRECTORY: C:/Users/Javier Franco/.local/share/gem/ruby/3.2.0
  - USER INSTALLATION DIRECTORY: C:/Users/Javier Franco/.local/share/gem/ruby/3.2.0
  - RUBY EXECUTABLE: C:/Ruby32-x64/bin/ruby.exe
  - GIT EXECUTABLE: C:\laragon\bin\git\bin/git.EXE
  - EXECUTABLE DIRECTORY: C:/Users/Javier Franco/.local/share/gem/ruby/3.2.0/bin
  - SPEC CACHE DIRECTORY: C:/Users/Javier Franco/.local/share/gem/specs
  - SYSTEM CONFIGURATION DIRECTORY: C:/ProgramData
  - RUBYGEMS PLATFORMS:
     - ruby
     - x64-mingw-ucrt
  - GEM PATHS:
     - C:/Users/Javier Franco/.local/share/gem/ruby/3.2.0
     - C:/Ruby32-x64/lib/ruby/gems/3.2.0
  - GEM CONFIGURATION:
     - :update_sources => true
     - :verbose => true
     - :backtrace => true
     - :bulk_threshold => 1000
     - "gem" => ["--install-dir", "C:/Users/Javier Franco/.local/share/gem/ruby/3.2.0", "--bindir", "C:/Users/Javier Franco/AppData/Local/Microsoft/WindowsApps"]
  - REMOTE SOURCES:
     - https://rubygems.org/
  - SHELL PATH:
     - C:\Ruby32-x64\bin
     - C:\Program Files\Eclipse Adoptium\jdk-17.0.7.7-hotspot\bin
     - C:\ProgramData\Oracle\Java\javapath
     - C:\Program Files (x86)\Common Files\Oracle\Java\javapath
     - C:\WINDOWS\system32
     - C:\WINDOWS
     - C:\WINDOWS\System32\Wbem
     - C:\WINDOWS\System32\WindowsPowerShell\v1.0\
     - C:\Program Files (x86)\D-Link\Central WifiManager\php5
     - C:\WINDOWS\System32\OpenSSH\
     - C:\ProgramData\ComposerSetup\bin
     - C:\laragon\bin\php\php-8.1.10-Win32-vs16-x64
     - C:\laragon\bin\nodejs\node-v18
     - C:\laragon\bin\yarn\bin
     - C:\laragon\bin\python\python-3.10
     - C:\laragon\bin
     - C:\laragon\bin\apache\httpd-2.4.54-win64-VS16\bin
     - C:\laragon\bin\composer
     - C:\laragon\bin\git\bin
     - C:\laragon\bin\git\cmd
     - C:\laragon\bin\git\mingw64\bin
     - C:\laragon\bin\git\usr\bin
     - C:\laragon\bin\laragon\utils
     - C:\laragon\bin\mysql\mysql-8.0.30-winx64\bin
     - C:\laragon\bin\nginx\nginx-1.22.0
     - C:\laragon\bin\ngrok
     - C:\laragon\bin\nodejs\node-v18
     - C:\laragon\bin\notepad++
     - C:\laragon\bin\php\php-8.1.10-Win32-vs16-x64
     - C:\laragon\bin\python\python-3.10
     - C:\laragon\bin\python\python-3.10\Scripts
     - C:\laragon\bin\redis\redis-x64-5.0.14.1
     - C:\laragon\bin\telnet
     - C:\laragon\bin\yarn\bin
     - C:\laragon\usr\bin
     - C:\Users\Javier Franco\AppData\Local\Yarn\config\global\node_modules\.bin
     - C:\Users\Javier Franco\AppData\Roaming\Composer\vendor\bin
     - C:\Users\Javier Franco\AppData\Roaming\npm
     - C:\Users\Javier Franco\AppData\Local\Microsoft\WindowsApps
     - C:\sqlite
     - C:\Ruby32-x64\bin

已尝试操作 #

• 卸载重装Ruby
• 以管理员身份运行命令
• 怀疑问题源于Ruby可执行路径未加双引号或路径含空格

错误分析 #

1. RUBYOPT无效参数：核心错误是invalid switch in RUBYOPT: -F，说明系统环境变量中RUBYOPT包含Ruby不兼容的-F参数，导致Ruby命令执行失败，进而中断了importmap:install流程。
2. Turbo/Stimulus安装失败：属于连锁问题，因为importmap:install未完成，项目缺少config/importmap.rb文件，触发了Turbo和Stimulus的依赖检查报错。

解决方案 #

1. 清理RUBYOPT环境变量 #

• 打开Windows「环境变量」设置：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在「用户变量」或「系统变量」中找到RUBYOPT，删除变量值中的-F参数（若变量无有效内容，直接清空）
• 重启命令行终端，确保环境变量生效

2. 补全Rails项目初始化步骤 #

进入项目目录执行以下命令：

cd C:/laragon/www/project
rails importmap:install
rails turbo:install stimulus:install

3. 解决路径空格问题（可选） #

用户目录C:/Users/Javier Franco含空格，可能引发gem路径解析问题，可调整gem配置：

gem config set install-dir "C:\Ruby32-x64\gems"
gem config set bindir "C:\Ruby32-x64\gems\bin"

重启终端后重新创建Rails项目测试。

内容的提问来源于stack exchange，提问作者Sebastián vasquez