PHP 和 Node.js 在每个环境中都已就绪。Python、Ruby、Go、.NET、Java 和 Flutter 在项目需要时提供:安装您想要的版本,多个版本并存,并为每个项目选择其中一个。系统包则添加某些包和测试构建时所依赖的库和工具。
项目使用哪个版本
python、ruby、go、dotnet 及其工具(pip、gem、bundle 等)按以下顺序选择版本:
- 项目自己的版本文件,例如
.python-version、.ruby-version或global.json; - 在面板上为该项目选择的版本;
- 默认版本。
在面板上
在侧边栏的服务器中打开服务器,然后进入运行时。在 Node.js 卡片之后的 Python、Ruby、Go、.NET、Java 和 Flutter 卡片中,每种语言各有一个区域:
- 添加版本会安装另一个版本系列:Python 3.11 至 3.14、Ruby 3.2 至 3.4、Go 1.25 至 1.27、.NET 8 至 10、Java 17、21、25 以及 Flutter 3.44、3.47。会安装该系列的最新发行版;这可能需要几分钟。
- 版本上的 ⋯ 菜单可将其设为默认或移除。默认版本以及被项目固定使用的版本无法移除。
- 项目版本可将项目固定到某个版本,或恢复为默认。
这需要 rdev 0.2.0-beta.36 或更高版本;在服务器运行该版本之前,卡片会提示您更新。.NET 会在服务器运行 rdev 1.0.6 或更高版本后出现,Flutter 则会在服务器的 rdev 更新到包含它的版本后出现。
Python 项目
每个 Python 项目在 .venv 中都有自己的虚拟环境,因此两个项目可以固定同一个包的不同版本。添加项目时,rdev 会创建该环境并安装依赖:项目有 uv.lock 时使用 uv sync,否则使用 pip 配合其 requirements.txt 或 pyproject.toml。开发服务器和项目的进程运行时,.venv 位于 PATH 的最前面。如果安装失败,项目仍会被添加,rdev 会显示需要在其文件夹中运行的命令。
.NET
.NET 8、9 和 10 可以并存安装,项目通过 global.json 选择其 SDK;没有该文件时,项目会使用已安装的最新 SDK。在面板上或用 rdev lang use 把项目固定到某个版本时,会自动为您写入该文件。包含 .csproj、.fsproj、.sln 或 .slnx 文件的项目会被识别为 .NET,其开发服务器以 dotnet watch run 启动,因此保存时会自动重新加载。每个 SDK 约占用 600 MB 磁盘空间。
您的站点在应用前端通过 HTTPS 提供服务,因此应用本身监听普通 HTTP。如果应用会重定向到 HTTPS 或生成绝对链接,请启用转发头(app.UseForwardedHeaders() 搭配 X-Forwarded-Proto),让它知道请求是通过 HTTPS 到达的。
SQL Server 目前还不能作为服务使用。请使用 PostgreSQL 或 MySQL 搭配 Entity Framework Core(Npgsql 或 Pomelo 提供程序),或连接到您在别处运行的 SQL Server。 你也可以通过 Tailscale 使用自己笔记本电脑上的 SQL Server:在 SQL Server 中启用 TCP/IP,在笔记本防火墙中向你的 Tailscale 网络开放 1433 端口,并在连接字符串中填写笔记本的 Tailscale 地址(Server=100.x.y.z,1433)。笔记本休眠时连接会中断。
Java
Java 25、21 和 17 可并存安装。它们都是长期支持版本,默认版本为 25。使用 rdev lang install java 25 安装其中一个。项目通过 .java-version 或 .tool-versions 文件选择版本;在面板中或用 rdev lang use java 21 将项目固定到某个版本时,会自动为您写入该文件。每个项目都会设置 JAVA_HOME。带有 pom.xml(Maven)或 build.gradle(Gradle)的项目会被识别为 Java 项目。
带有 mvnw 包装器的 Spring Boot 项目会在约 8 秒内重新加载修改后的代码:src 下的文件变化时,rdev 会重新编译。Quarkus 运行在会自行重新加载的开发模式下。
Java 开发服务器大约占用 350–700 MB 内存,因此在小型服务器上请同时只运行少量 Java 项目。
Flutter
像添加其他项目一样添加 Flutter 应用:克隆它,或从 Flutter 配方开始;rdev 通过 pubspec.yaml 识别它。当应用有 Web 目标(即 web 文件夹)时,它的 Web 预览会运行在 https://<project>.dev.test,并在您保存时重新加载;首次构建大约需要半分钟。在手机、模拟器或仿真器上,它从您自己的电脑运行:开启文件同步后,在笔记本电脑上打开同一个项目文件夹,并在那里运行 flutter run。iOS 构建需要装有 Xcode 的 Mac。没有 Web 目标的应用会在不带开发服务器的情况下添加。在服务器上,flutter pub get、flutter analyze、flutter test 和 flutter build web 可供您和您的智能体使用。添加 Flutter 项目需要 rdev 1.4.3 或更高版本;Flutter 配方从 1.4.2 起可用。
使用 rdev lang install flutter 3.47 安装版本;Dart 随之附带,因此 dart 也可使用。项目通过 .fvmrc(即 FVM 写入的格式)或 .tool-versions 文件选择版本,否则使用在面板上选择的版本或默认版本。每个版本约占用 1 GB 磁盘空间。
Flutter 会把这台电脑自己的路径写入一些生成的文件(.dart_tool, .flutter-plugins-dependencies, ios/Flutter/Generated.xcconfig, android/local.properties),因此文件同步会将它们排除在外:笔记本电脑和服务器各自保留自己的那份,flutter pub get 会重新生成它们。请不要把 Android 签名密钥(key.properties 和 keystore)提交到 git。
系统包
系统包卡片可一键安装成组的系统库和工具:
| 组 | 用途 |
|---|---|
| 构建工具 | 编译器,以及原生扩展(Python wheel、Ruby gem、npm 插件)构建所用的头文件 |
| PostgreSQL 客户端 | psql 以及数据库驱动所链接的库 |
| MySQL 客户端 | mysql 以及数据库驱动所链接的库 |
| 图像库 | 图像处理,例如 Pillow 或 sharp |
| Canvas 库 | 绘图和 PDF 渲染,例如 node-canvas |
| XML 库 | XML 解析,例如 lxml 或 Nokogiri |
| FFmpeg | 视频和音频转换 |
| Chromium | 用于浏览器测试和 PDF 生成的无头浏览器 |
| GitHub CLI | 用于 GitHub 的 gh 命令:拉取请求、议题、发布和 Actions。先用 gh auth login 登录一次 |
| ICU 库 | .NET 所需的 Unicode 和语言数据;随第一个 .NET 版本自动安装 |
移除某个组之前会先询问:基于它构建或运行的项目可能无法工作,直到重新安装。rdev 更新环境后,所选的组会自动恢复。Chromium 在环境的容器内运行,因此请使用 --no-sandbox 启动它(Puppeteer:args: ['--no-sandbox'])。
在服务器上
rdev lang list # installed and available versions, defaults and project choices
rdev lang install python 3.13 # the newest 3.13 release
rdev lang default python 3.13
rdev lang use shop python 3.12 # pin a project; rdev lang use shop python default undoes it
rdev lang remove python 3.12
rdev lang install dotnet 10
rdev lang install flutter 3.47 # Flutter with its Dart
rdev system list
rdev system install postgres # build tools, postgres, mysql, images, canvas, xml, ffmpeg, chromium, gh, tauri
rdev system remove postgres
python、pip、ruby、gem、bundle、go、gofmt、dotnet、flutter 和 dart 首先遵循项目自己的版本文件(.tool-versions、mise.toml、.python-version、.ruby-version、go.mod 的 go 行、global.json、.fvmrc),其次是为项目选择的版本,最后是默认版本;未安装的版本会停止并提示您安装。智能体使用相同的命令,并通过 MCP 使用 rdev_lang_list、rdev_lang_install、rdev_lang_project 和 rdev_system_install(当智能体发现原生构建失败,例如“pg_config not found”时,会安装正确的组)。由 pip install 或 gem install 添加的命令,请使用 python -m、虚拟环境、bundle exec 或 gem exec 运行。