
如果您希望在Windows系统上搭建Ruby开发环境,但尚未安装Ruby解释器和gem包管理工具,则可能是由于缺少官方推荐的安装方式。以下是使用RubyInstaller完成安装的详细步骤:
一、下载RubyInstaller安装程序
RubyInstaller是专为Windows平台优化的Ruby发行版,内置了Ruby解释器、DevKit(用于编译本地扩展)以及预配置的gem工具。它避免了手动编译的复杂性,并确保环境开箱即用。
1、打开浏览器,访问RubyInstaller官网 https://rubyinstaller.org/downloads/。
2、在页面中找到最新稳定版本(如Ruby 3.3.x),点击对应链接下的“Download”按钮。
3、选择带有“with DevKit”字样的安装包(例如:rubyinstaller-3.3.0-1-x64.exe),该版本已集成构建工具链。
二、运行安装程序并配置基础选项
安装过程会引导用户设置Ruby的安装路径、环境变量及可选组件。正确勾选关键选项可避免后续命令行无法识别ruby或gem命令的问题。
1、双击下载好的.exe文件启动安装向导。
2、在欢迎界面点击“Next”继续。
3、在安装路径页面,确认路径不含中文或空格(如C:\Ruby33-x64),点击“Next”。
4、在可选任务页面,务必勾选“Add Ruby executables to your PATH”和“Associate files with Ruby”两项。
5、点击“Install”开始安装,等待进度条完成。
三、验证Ruby与gem是否安装成功
安装完成后需在命令提示符中确认ruby和gem命令是否可用,这是判断环境是否就绪的核心检查点。
1、按Win + R键,输入cmd并回车,打开命令提示符窗口。
2、输入命令:ruby -v,回车后应显示类似ruby 3.3.0p100 (2024-06-18 revision 76c315a1e1) [x64-mingw-ucrt]的版本信息。
3、输入命令:gem -v,回车后应显示gem当前版本号(如3.5.10)。
4、输入命令:which ruby(若使用Git Bash)或where ruby(若使用CMD),确认返回路径指向RubyInstaller安装目录。
四、升级gem并配置国内镜像源
默认gem源位于rubygems.org,国内访问较慢,更换为淘宝或清华镜像源可显著提升包安装速度。同时升级gem至最新版本有助于兼容新发布的RubyGems规范。
1、在命令提示符中执行:gem update –system,等待升级完成。
2、查看当前源列表:gem sources -l,确认输出包含https://rubygems.org/。
3、移除原源:gem sources –remove https://rubygems.org/。
4、添加清华镜像源:gem sources –add https://mirrors.tuna.tsinghua.edu.cn/rubygems/。
5、再次执行gem sources -l,确认仅剩清华源且末尾显示[CURRENT]。
五、安装常用开发相关gem包
完成基础环境后,可根据开发需求安装常用工具类gem,例如Bundler用于依赖管理、Jekyll用于静态网站生成等。这些包将被安装到当前Ruby环境的全局gem目录中。
1、安装Bundler:gem install bundler。
2、安装Jekyll:gem install jekyll。
3、安装Rails(如需Web框架):gem install rails。
4、验证Bundler是否生效:bundle -v,应输出版本号。
5、创建测试项目目录并初始化Gemfile:mkdir myapp && cd myapp && bundle init。

评论(0)