WebStorm项目端口非全局设置，需按运行配置单独指定：JavaScript Debug配置不控制端口，内置服务器端口须在Settings→Advanced Settings→Built-in Server Port修改并重启IDE；npm/yarn项目端口由脚本控制，如package.json中添加--port参数；Node.js配置可在Application parameters传参，npm配置需用Arguments栏双横线透传；端口冲突时可用lsof或netstat查PID并终止，或直接改配置端口，同时注意同步前端API地址。
WebStorm 项目运行端口不是全局设置，而是按运行配置（Run Configuration）单独指定的——改错地方就永远不生效。
JavaScript Debug 配置里改不了端口？因为根本不在那儿
很多人在新建 JavaScript Debug 配置时盯着 URL 字段猛改，比如硬把 http://localhost:63342/index.html 改成 :8080，结果启动失败或仍走 63342。原因很直接：JavaScript Debug 本身不启动服务，它只是告诉浏览器去哪连——而那个地址背后的服务，是 WebStorm 内置静态服务器提供的，端口由 IDE 全局控制，不归这个配置管。
-
JavaScript Debug的URL必须指向 WebStorm 内置服务已监听的端口（默认63342），否则打不开 - 想换端口，得去
Settings → Advanced Settings → Built-in Server Port改（路径可能因版本略有差异，搜Built-in最快） - 改完要重启 WebStorm 才生效，旧的
JavaScript Debug配置里的 URL 也得手动同步更新
npm / yarn 启动的项目（如 Vue、React）端口在哪改
这类项目实际由 Node.js 进程起服务（比如 vue-cli-service serve），WebStorm 只是调用命令行。端口由脚本自身控制，和内置服务器无关。
- 常见方式是在
package.json的scripts里加参数，例如："serve": "vue-cli-service serve --port 8081" - 也可以在
.env文件中写：VUE_APP_PORT=8081（Vue CLI）或PORT=8081（Create React App） - 如果用的是自定义 Node.js 脚本（如
server.js），端口通常在app.listen()调用里，直接改参数即可
运行配置（Run Configuration）里真能设端口的地方
只有两类配置支持显式填端口字段：
-
Node.js配置：在Application parameters或Environment variables里传参，比如加--port=3001；Port字段本身只用于调试器连接，不影响服务端口 -
npm配置：没有独立端口字段，靠Scripts和Arguments控制；在Arguments栏填-- --port=8082（注意双横线分隔）可透传参数给底层脚本 - 其他如
Tomcat Server、Jetty等 Java 容器配置，端口字段明确可见，在Server port或HTTP port里改
端口冲突了怎么快速定位和换掉
报错类似 Error: listen EADDRINUSE: address already in use :::8080，说明端口被占。别急着杀进程，先确认是谁在用：
- 终端执行：
lsof -i :8080（macOS/Linux）或netstat -ano | findstr :8080（Windows） - 看到 PID 后，用
kill -9 <PID>或taskkill /PID <PID> /F干掉（谨慎操作，避免误杀数据库等关键服务） - 更省事的做法：在 WebStorm 的运行配置里直接换端口，比如把
8080改成8083，保存后重跑——前提是你的启动脚本支持该参数
真正容易被忽略的是：改了端口后，前端代码里硬编码的 API 地址（如 fetch('http://localhost:8080/api')）很可能没同步更新，导致跨域或 404。别只盯 WebStorm 配置，前后端端口要对齐。
