webstorm代理配置需分层排查：terminal需改shell路径并硬编码代理变量，插件市场需关闭https解密，license校验需hosts屏蔽+离线模式，git推送需重置凭据助手。
WebStorm 代理配置失败，不是填了地址就完事——它会受系统代理、终端环境变量、IDE 内置 HTTP Proxy 设置、插件市场请求链路、甚至 JVM 启动参数多重干扰。填对了也连不上，是常态。
WebStorm Terminal 里命令走不了代理？查 shell 和环境变量隔离
现象：CMD 或 PowerShell 里 git、npm、gemini 都能联网，但 WebStorm 内置 Terminal 一跑就报 fetch failed 或超时。根本原因是 Terminal 默认不继承你手动设的 http_proxy 环境变量，尤其 PowerShell 完全独立于 CMD 的环境上下文。
- 进
Settings > Tools > Terminal，把Shell path改成你日常用的 shell（如pwsh.exe或/bin/bash），别用默认cmd.exe（它不读用户级环境变量） - 更稳妥的做法：在 Node.js 安装目录下建
gemini.cmd或gemini.ps1，开头硬编码设置HTTP_PROXY和HTTPS_PROXY，绕过环境变量继承问题 - Mac 用户注意：
open -a WebStorm从终端启动时，会继承当前 shell 的http_proxy；先unset http_proxy https_proxy再启动可快速验证是否为环境变量污染
插件市场搜不到 Chinese Language Pack？代理静默拦截了请求
搜索框空着、没报错、也没加载动画——这不是插件下架，而是 plugins.jetbrains.com 请求被代理或防火墙截断后，IDE 直接返回空列表。浏览器能打开官网 ≠ IDE 能通插件市场，TLS 握手阶段就可能失败。
- 临时关闭 Clash、Surge、企业网关 HTTPS 解密策略，直连 https://www.php.cn/link/9e8a5c1f4174912f20cdad10d566a2d2 确认页面正常
- 进
Settings > Appearance & Behavior > System Settings > HTTP Proxy，确认没误启Auto-detect proxy settings；公司内网建议选Manual proxy configuration并填明确地址 - Mac/Linux 用户检查
~/.bashrc或~/.zshrc是否 export 过http_proxy，IDE 启动方式不同（桌面图标 vs 终端）会导致加载差异
WebStorm 启动卡在 “We could not validate your license”？不是激活码问题
提示出现 ≠ 激活失败，99% 是验证域名连不通。2024 年起校验变严，每周多次后台请求 account.jetbrains.com、licensing.jetbrains.com 等，任一失败即弹窗。
- 最有效解法：编辑系统
hosts文件，追加四行屏蔽（Windows 用管理员记事本，macOS/Linux 用sudo nano /etc/hosts）：0.0.0.0 account.jetbrains.com0.0.0.0 www.jetbrains.com0.0.0.0 licensing.jetbrains.com0.0.0.0 api-license.jetbrains.com - 必须配合启用离线模式：进配置目录（如
%APPDATA%\JetBrains\WebStorm2026.1\options\other.xml），在<application></application>下加<option name="offlineMode" value="true"></option> - 别漏掉系统时间：误差 >5 分钟会导致 TLS 证书校验失败，现象一模一样；Windows 用户务必进“Internet 时间”点“立即更新”
Git 推送报 Authentication failed，但终端能推？凭证链没对齐
WebStorm 复用系统 Git 凭证管理器，但它调用方式和终端不同——可能读了过期的 token 却不弹窗，也可能跳过了 SSH agent 加载。
- 先查 Git 当前凭据助手：
git config --global credential.helper，常见值为manager（Win）、osxkeychain（macOS）、store（Linux） - Win 用户去“凭据管理器 → Windows 凭据”，删掉所有
git:https://gitee.com或git:https://github.com条目；Linux/macOS 删~/.git-credentials - 执行
git config --global --unset credential.helper，让下次 WebStorm Push 强制弹窗，输入用户名 + 个人访问令牌（PAT），不是密码 - 替代方案：装官方
Gitee插件，走 OAuth 授权，完全绕过 Git 凭据链
代理问题最麻烦的点不在“设不设”，而在“哪一层在生效”。Terminal、插件市场、License 校验、Git 凭据、甚至 JVM 启动参数都可能各自读一套代理逻辑。改一处没用，得按请求发起方逐层排查，而不是统一塞一个环境变量了事。
