如何在WSL/Ubuntu环境中通过命令行打开WebStorm?
WSL环境下WebStorm等效
code .的命令行配置方法 WebStorm 原生提供命令行启动能力,你遇到的命令不存在、Toolbox仅生成.cmd文件无法调用的问题,属于WSL跨系统调用的适配问题,按你实际的安装场景选对应方案配置即可:
方案一:使用WSL原生安装的WebStorm(运行在WSLg环境)
该方案配置最简单,和原生Linux环境逻辑完全一致:
- 启动安装在WSL内的WebStorm
- 顶部菜单栏依次选择
Tools→Create Command-line Launcher - 弹窗确认后,工具会自动在
/usr/local/bin目录下生成名为webstorm的可执行软链
配置完成后,终端内执行webstorm .即可打开当前目录,和VS Code的code .用法完全一致,支持传入任意文件、目录路径作为启动参数。
方案二:使用Windows侧安装、JetBrains Toolbox管理的WebStorm
Toolbox默认生成的.cmd是Windows平台专用脚本,直接在WSL调用会因为路径格式不兼容失效,手动做路径适配即可:
- 先定位WebStorm启动脚本的位置:Toolbox默认将启动脚本存在Windows路径
C:\Users\你的Windows用户名\AppData\Local\JetBrains\Toolbox\scripts下,目录内可找到webstorm.cmd文件;如果找不到该文件,可以打开Toolbox的设置页,查看「生成Shell脚本」的配置项里填写的脚本存放路径。 - 打开当前WSL环境使用的Shell配置文件,Bash对应
~/.bashrc、Zsh对应~/.zshrc,在文件末尾添加别名配置:- 如果WSL默认继承了Windows的PATH环境变量(默认配置都是继承的),添加以下内容即可:
alias webstorm='cmd.exe /c webstorm.cmd "$(wslpath -w "${1:-.}")"'- 如果提示找不到
webstorm.cmd,直接写脚本的完整WSL路径即可,比如Windows用户名为Demo时的配置:
alias webstorm='/mnt/c/Users/Demo/AppData/Local/JetBrains/Toolbox/scripts/webstorm.cmd "$(wslpath -w "${1:-.}")"'
配置说明:
wslpath -w会自动将WSL格式的路径转换为Windows可识别的路径格式;${1:-.}表示未传入参数时默认打开当前目录,和code .的默认行为完全对齐。
- 保存配置文件后,执行
source ~/.bashrc(替换为你实际使用的配置文件路径)让配置立即生效。
常见问题排查
- 输入
wstorm提示命令不存在:wstorm是极早期WebStorm版本的遗留命令名,新版默认启动命令为webstorm,不存在wstorm这个命令。 - 唤起WebStorm后提示路径不存在:基本是路径未做格式转换导致,检查别名配置中是否包含
wslpath -w的路径转换逻辑。 - 启动时提示权限不足:给对应启动脚本、软链添加可执行权限即可,比如执行
sudo chmod +x /usr/local/bin/webstorm。
内容的提问来源于stack exchange,提问作者Adrian
相关产品推荐
相关产品推荐

