JetBrains Rider 是一款专为 .NET 和跨平台开发设计的现代化集成开发环境（IDE）。它深度整合了 IntelliJ 平台的智能代码辅助、强大导航和重构能力，并针对 C#、F#、VB.NET、ASP.NET、Unity 和 Godot 等提供了卓越的支持。本指南将详细介绍如何在 Mac 系统上高效使用 Rider。

一、核心界面与工作区详解

启动 Rider 后，您将看到一个高度可定制但逻辑清晰的主界面，主要分为以下几个区域：

顶部菜单栏与工具栏：提供文件、编辑、视图、导航、代码、重构、工具等全局命令的访问。工具栏包含常用操作（如运行、调试）的快捷按钮。
导航栏（Navigation Bar）：位于主窗口顶部，显示项目结构、当前文件路径，并允许快速在项目文件和文件夹间跳转。
解决方案资源管理器（Solution Explorer）：通常位于左侧。它以树状结构展示整个解决方案（Solution）、项目（Project）、文件、引用和 NuGet 包。这是管理项目结构的核心面板。
编辑器区（Editor）：中央最大区域。用于编写和查看代码，支持标签页（Tabs）同时打开多个文件。提供语法高亮、代码折叠、错误波浪线、内嵌文档和代码透镜（如引用数、测试状态）等功能。
工具窗口（Tool Windows）：分布在编辑器周围，可通过底部和侧边的按钮或快捷键激活。
- 底部：包含“问题”（Problems，显示错误和警告）、“终端”（Terminal）、“运行”（Run，显示程序输出）、“调试”（Debug，变量和调用栈）、“单元测试”（Unit Tests）等。
- 右侧：包含“数据库”（Database）、“NuGet”包管理器、“项目结构”（Project Structure）等。
状态栏（Status Bar）：位于窗口底部，显示项目状态、编码、行号/列号、Git 分支等信息。

二、完整操作流程：从项目到导出

1. 创建或打开项目

步骤1：启动Rider。在欢迎界面，您可以选择：

新建项目（New Solution）： 点击 “New Solution”。
打开现有项目（Open）： 点击 “Open”，浏览并选择您的 `.sln` 解决方案文件或项目文件夹。
从版本控制克隆（Get from VCS）： 点击 “Get from VCS”，输入 Git、SVN 等仓库地址。

步骤2：配置新项目。如果选择新建，在弹出的对话框中：

在左侧选择项目类型（如 Console Application, ASP.NET Core Web API, Class Library）。
在右侧配置项目名称（Name）、位置（Location）、目标框架（Target Framework）等。
点击 “Create”。

2. 编写与编辑代码

步骤3：在解决方案资源管理器中操作。右键点击项目或文件夹，选择 Add -> New Item... 或 Existing Item... 来添加新文件或现有文件。

步骤4：使用智能编辑。在编辑器中：

代码补全： 输入时按 Ctrl + Space 触发基础补全，Rider 会持续提供上下文相关的建议。
快速导航： 按住 Cmd 并点击（或使用 F12）类、方法、变量名，跳转到其定义。使用 Cmd + B 实现相同功能。
查找： 在当前文件中查找按 Cmd + F；全局查找按 Cmd + Shift + F。

3. 构建与运行

步骤5：构建项目。点击顶部工具栏的锤子图标 🔨，或使用快捷键 Cmd + Shift + B。构建输出和错误信息会显示在“生成”（Build）工具窗口中。

步骤6：运行/调试程序。

运行： 点击编辑器左侧运行图标（绿色三角形），或使用快捷键 Ctrl + F5。也可从顶部工具栏下拉菜单中选择启动配置并点击运行按钮。
调试： 点击运行图标旁的虫子图标，或使用快捷键 F5。在代码行号左侧点击设置断点。

运行/调试输出显示在底部的“运行”（Run）或“调试”（Debug）工具窗口。

4. 测试

步骤7：运行单元测试。在测试方法或类旁点击运行图标，或右键点击选择“运行测试”（Run Tests）。所有测试结果汇总在“单元测试”（Unit Tests）工具窗口中。快捷键：在测试上下文中，Ctrl + T, R 运行测试；Ctrl + T, D 调试测试。

5. 版本控制集成

步骤8：提交更改。 Rider 内置了强大的 Git 支持。左侧的“提交”（Commit）工具窗口（Cmd + 9）显示更改的文件。编写提交信息后，点击“提交”或“提交并推送”。

6. 导出与发布

步骤9：发布项目。对于 .NET Core/5+ 项目：

在解决方案资源管理器中右键点击目标项目。
选择“发布”（Publish）。
在打开的“发布”工具窗口中，点击“创建新的发布配置文件”。
选择目标（如文件夹、FTP、Azure等），配置路径和设置。
点击“发布”按钮即可生成可部署的文件。

发布输出通常位于项目的 `bin/Release/{TARGET_FRAMEWORK}/publish/` 文件夹下。

三、常用功能进阶技巧

多重光标： 按住 Option 并拖动鼠标可以添加垂直选择块。按 Ctrl + G 可以选中下一个相同词。
快速重构： 将光标置于待重构的代码上，按 Ctrl + T 打开重构菜单。常用操作如重命名（F2）、提取方法（Cmd + Alt + M）、提取变量（Cmd + Alt + V）。
导航到 everywhere： 按 Shift + Shift（双击 Shift），可以搜索类、文件、操作、设置等一切内容。
本地历史（Local History）： 右键点击文件或文件夹，选择“本地历史” -> “显示历史”，可以查看 IDE 自动保存的本地更改记录，是未提交 Git 时的救命稻草。
数据库工具： 右侧的“数据库”工具窗口允许直接连接并操作数据库，编写 SQL 语句，结果会智能显示在编辑器中。

四、常见问题与解决方案

Q1: 项目无法加载或依赖项显示错误？

解决方案： 尝试右键点击解决方案资源管理器中的解决方案或项目，选择“重新加载项目”。如果涉及 NuGet 包，可以右键点击项目选择“还原 NuGet 包”，或使用终端在项目目录执行 dotnet restore。

Q2: 智能提示（IntelliSense）不工作或代码有红色波浪线但编译正常？

解决方案： 这通常是 Rider 的解决方案缓存损坏所致。点击菜单栏 File -> Invalidate Caches...，然后选择“Invalidate and Restart”。重启后问题通常解决。

Q3: 快捷键冲突（尤其是与系统快捷键冲突）？

解决方案： 进入 Rider -> Preferences -> Keymap。在搜索框中输入冲突的功能，可以查看当前绑定并修改。也可以直接在上面搜索 macOS 系统操作（如“显示桌面”），查看是否被 Rider 占用并修改。

Q4: 运行或调试时提示“无法找到 SDK”或目标框架错误？

解决方案： 确保已安装正确的 .NET SDK。在终端输入 dotnet --list-sdks 查看。在 Rider 中，进入 Preferences -> Build, Execution, Deployment -> Toolset and Build，检查检测到的 .NET Core SDK 路径是否正确。也可以在项目文件 (.csproj) 中检查 “ 标签是否与已安装的 SDK 匹配。

五、Mac版 Rider 快捷键汇总表

功能分类	操作描述	快捷键 (Mac)
通用操作	打开设置/偏好	Cmd + ,
编辑	基本代码补全	Ctrl + Space
格式化代码	Ctrl + Alt + L
复制当前行	Cmd + D
导航	跳转到定义	Cmd + B 或 F12
查找类	Cmd + O
查找文件	Cmd + Shift + O
查找所有（双 Shift）	Shift + Shift
重构	重命名	F2
提取方法	Cmd + Alt + M
显示重构选项	Ctrl + T
构建与运行	构建解决方案	Cmd + Shift + B
运行（不调试）