如何在Rider 2025.1中通过WSL运行应用程序(支持调试与非调试模式)
如何在Rider 2025.1中通过WSL运行应用程序(支持调试与非调试模式)
我之前也碰到过一模一样的情况!公司要求只用Rider开发,没法依赖VS的自动WSL检测,折腾了好一阵才搞定,给你分享亲测有效的配置步骤:
1. 先确认Rider的WSL工具链配置
打开Rider的「File > Settings」(快捷键Ctrl+Alt+S),找到「Build, Execution, Deployment > Toolchains」:
- 点击「+」号,选择「WSL」,然后选中你安装的Ubuntu发行版
- Rider会自动扫描WSL里的.NET SDK,如果没自动检测到,手动指定路径为
/usr/dotnet/dotnet(这是Ubuntu下.NET SDK的默认安装路径) - 记得把这个WSL工具链设为默认,或者至少确保项目会使用它
2. 配置项目的运行/调试参数
点击右上角的运行配置下拉框,选择「Edit Configurations...」:
- 找到你的目标项目(控制台应用、Web应用都适用),进入配置页面
- 在「Target runtime」选项里,选择你对应的WSL发行版(比如Ubuntu-22.04)
- 确认「Run on」选项设置为「WSL」,如果是Web应用,Rider会自动处理端口转发,要是遇到访问问题,可以手动在配置里添加端口映射(比如把WSL的5000端口映射到Windows的5000端口)
3. 检查项目的SDK与运行时设置
右键项目,选择「Properties」(快捷键Alt+Enter),进入「Application」标签:
- 确保「Target framework」选择的是你在WSL里安装的.NET 8.0版本
- 把「Runtime identifier (RID)」设置为
linux-x64(如果是ARM架构的WSL,就设为linux-arm64),避免Rider默认用Windows的运行时
4. 用命令行验证(排查问题的关键)
如果上面的步骤做完还是没法运行,打开Rider的Terminal面板,切换到你的WSL发行版(点击Terminal下拉框选择对应的Ubuntu),然后运行:
dotnet run
如果命令行能正常启动应用,说明是Rider的配置没生效,回到运行配置页面再仔细核对一遍;如果命令行也报错,那可能是WSL里的.NET环境有问题,重新安装一遍.NET 8.0 SDK试试。
几个额外的小技巧
- 确保WSL是2版本:在Windows终端里运行
wsl --set-default-version 2,再用wsl --set-default Ubuntu把Ubuntu设为默认发行版 - 要是Rider没检测到WSL,试试重启Rider或者先关闭WSL(
wsl --shutdown)再重新启动 - Web应用调试时,直接在Windows浏览器访问
localhost:端口号就行,Rider会自动把WSL的端口转发到Windows
内容来源于stack exchange
相关产品推荐
相关产品推荐

