WebStorm远程开发需满足三项硬指标：GLIBC≥2.28、内存≥2GB、SSH用户shell为/bin/bash或/bin/zsh；私钥须OpenSSH格式且权限600，Host别名大小写必须严格匹配；Node路径须绝对路径，non-interactive shell不加载shell配置。
WebStorm 通过 SSH 远程开发不是“配个解释器+上传代码”——它本质是让 JetBrains Gateway 在远端启动一个完整 IDE 后端，本地只做显示和输入。能连上 SSH 不代表能用远程开发，必须满足硬性条件。
远程开发前必须验证的三项硬指标
JetBrains Gateway 启动的远端 IDE 后端对服务器有明确要求，跳过检查大概率卡在“检查连接并继续”或白屏：
-
ldd --version输出的 GLIBC 版本 ≥ 2.28（CentOS 7 默认是 2.17，不兼容；Ubuntu 20.04+、Debian 11+ 通常达标） -
free -h显示可用内存 ≥ 2GB（IDE 后端自身常驻约 1.2–1.5GB，低于此值会频繁 OOM 或无法启动） - SSH 用户 shell 必须是
/bin/bash或/bin/zsh，不能是/usr/sbin/nologin或/bin/false（grep $USER /etc/passwd查看）
SSH 配置失败最常见的三个静默原因
WebStorm 不报错，但连接卡住或提示 Authentication failed，实际往往不是密码/密钥输错：
- 私钥格式不对：WebStorm 只接受 OpenSSH 格式（
-----BEGIN OPENSSH PRIVATE KEY-----），PuTTY 的.ppk文件无效，需用puttygen转换导出为 OpenSSH 格式 - 私钥权限未设为 600：
chmod 600 ~/.ssh/id_rsa，否则 SSH 协议层拒绝读取，WebStorm 完全不提示 - SSH Config 中的
Host别名大小写不匹配：WebStorm 严格比对~/.ssh/config里的Host myserver，填成MyServer就连不上
Node.js 环境变量丢失导致 npm 找不到
远程开发模式下，JetBrains Gateway 启动的是 non-interactive shell，~/.bashrc 和 ~/.zshrc 完全不加载，所以 node、npm、npx 全部不可见：
- 不要指望 WebStorm 自动查
$PATH—— 它只认你手动填进Node interpreter path的绝对路径，运行which node后粘贴结果（如/home/user/.nvm/versions/node/v18.18.2/bin/node） -
~不展开：填~/.nvm/...会失败，必须写成完整绝对路径 - 更稳妥的做法是建 wrapper 脚本：
/home/user/bin/npm-wrapper，内容为#!/bin/bash\nsource ~/.bashrc && exec npm "$@"，然后在 WebStorm 的 Run Configuration →npm package manager路径里指向它
首次连接后 IDE 卡在“正在加载项目”怎么办
这不是网络慢，而是远端 IDE 后端没真正跑起来：
- 先手动 SSH 登录服务器，执行
ps aux | grep jetbrains，确认有没有jb-gateway或webstorm进程；没有就说明启动失败 - 查看远端日志：
~/.cache/JetBrains/RemoteDev/logs/idea.log，常见错误是Cannot allocate memory（内存不足）或GLIBC_2.28 not found - 若服务器无法访问
https://download.jetbrains.com，Gateway 无法自动下载 IDE 后端，需提前传WebStorm-*.tar.gz并在向导中选“从本地上传”
远程开发一旦跑通，后续所有操作（索引、调试、npm install）都在服务端发生，本地几乎零负载。但它的脆弱点很集中：服务器环境是否干净、GLIBC 和内存是否达标、SSH 配置是否严格合规——这些地方错一点，整个流程就停在第一步。
