rubymine创建rails应用程序指南

1. 确认 Ruby 和 Rails 环境已就绪
   在开始创建 Rails 应用之前，先确认本机已经安装 Ruby 和 Rails。打开 RubyMine 内置终端（Alt+F12），输入 ruby -v 和 rails -v，如果命令不存在，说明环境未配置。此时需要先安装 Ruby（建议使用 rbenv 或 RVM）并执行 gem install rails 安装 Rails。如果已经安装但 RubyMine 识别不到，请在 Settings（设置）→ Languages & Frameworks → Ruby SDK 中检查并选择正确的 Ruby 解释器。这一步是创建应用的基础，避免后续出现「找不到 rails」或「无法生成项目」的问题。
2. 使用 New Project 向导创建 Rails 项目
   打开 RubyMine，点击 File → New Project。在左侧项目类型列表中选择「Rails」或「Ruby on Rails」（不同版本名称略有差异）。右侧会显示项目名称、位置、Ruby SDK 等选项。关键点是选择「Rails 应用」而不是「空 Ruby 项目」。设置好项目名称和路径后，点击 Create，RubyMine 会自动调用 rails new 命令生成项目骨架。如果向导中没有 Rails 选项，说明 RubyMine 的 Rails 插件未启用，请到 Settings → Plugins 中搜索「Rails」并启用。
3. 通过终端手动创建 Rails 应用（备选方案）
   如果你更喜欢手动控制，可以不用向导。在 RubyMine 中打开终端，切换到你想存放项目的目录，然后输入 rails new myapp 命令（myapp 是你的应用名称）。执行后会在当前目录生成一个完整的 Rails 项目。之后在 RubyMine 中点击 File → Open，选择刚生成的文件夹，RubyMine 会识别并加载项目。这种方式更灵活，可以附加参数，比如 rails new myapp --database=postgresql 来指定数据库。注意，手动创建后需要确保 RubyMine 的 SDK 设置正确，否则可能无法运行。
4. 配置数据库和 Gemfile 依赖
   创建完成后，打开项目中的 Gemfile 文件，查看默认的数据库驱动（默认是 sqlite3）。如果你使用 PostgreSQL 或 MySQL，需要修改 Gemfile 中的 gem 行，例如将 gem 'sqlite3' 替换为 gem 'pg' 或 gem 'mysql2'。然后运行 bundle install 安装依赖。接着编辑 config/database.yml 文件，填写数据库的用户名、密码、主机等信息。最后在终端执行 rails db:create 创建数据库。这一步是让应用能正常连接数据库，否则启动服务器时会出现数据库连接错误。
5. 启动 Rails 服务器并验证应用
   在 RubyMine 中启动 Rails 服务器有两种方式。第一种：点击右上角的运行配置下拉框，选择「Development: Rails server」或「Rails server」，然后点击绿色运行按钮。第二种：在终端输入 rails server 或 rails s。启动后，RubyMine 的 Run 窗口会显示日志，当看到「Listening on」或「* Listening on tcp://localhost:3000」时，说明服务器已启动。打开浏览器访问 http://localhost:3000，如果看到 Rails 欢迎页面，说明创建成功。如果端口被占用，可以修改 config/puma.rb 中的端口号，或使用 rails server -p 3001 指定新端口。
6. 常见问题：创建后无法运行或报错
   如果创建过程中遇到问题，先检查 RubyMine 的日志（Help → Show Log in Explorer）。常见问题包括：Ruby SDK 未配置（在 Settings 中重新选择）、bundle install 失败（检查网络或 Gemfile 源）、数据库连接失败（确认 database.yml 和数据库服务）。如果 rails new 命令卡住，可能是网络问题，可以换成国内镜像源（在 Gemfile 中修改 source 为 https://gems.ruby-china.com）。不要轻易删除项目，先根据错误信息逐项排查。如果问题依旧，可以尝试在终端手动运行 rails new 命令，看是否有更详细的错误输出。

软件页面：RubyMine。