VS Code 启动报 EADDRINUSE 是因扩展或本地服务占用端口，需定位占用进程并修改对应扩展端口配置（如 Live Server 的 liveServer.settings.port），而非修改 VS Code 全局设置。
VS Code 启动时提示 EADDRINUSE 或 “端口已被占用”
这是最常见的情况：VS Code 的某些扩展（比如 Remote-SSH、Live Server、Debugger for Chrome）或你本地跑的其他服务占用了它默认想用的端口，比如 3000、8080、5001，甚至 VS Code 自身的 server 端口（如 8080 用于 Web 版 VS Code）。错误信息里通常带 EADDRINUSE，意思是“地址已在使用中”。
解决思路不是“改回原端口”，而是明确谁在用、能不能换、要不要关——因为 VS Code 本身不直接暴露“端口号配置入口”，端口由具体功能模块控制。
- 先查哪个进程占了端口：
lsof -i :3000（macOS/Linux）或netstat -ano | findstr :3000（Windows），再用tasklist | findstr <pid></pid>定位进程 - Live Server 扩展默认用
5500，可在设置里搜liveServer.settings.port改成别的，比如5501 - Remote-SSH 连接失败时，不是改 VS Code 端口，而是检查远程服务器上的
sshd是否监听了22，或者你是否误配了remote.SSH.configFile导致跳转到错误端口 - Web 版 VS Code（
code-server）才真正需要手动指定端口，启动命令加--port=8081即可，但这是独立服务，和桌面版 VS Code 无关
修改 VS Code 扩展的端口配置项（以 Live Server 为例）
很多用户以为“VS Code 有个全局端口设置”，其实没有。端口是各扩展自己管的，必须进对应扩展的设置改。Live Server 是最常被问到的，因为它启动后自动打开浏览器，默认端口冲突高发。
操作路径：打开设置（Cmd+, 或 Ctrl+,）→ 搜索 liveServer.settings.port → 输入新端口号（如 8082）→ 保存。改完需重启 Live Server（点右下角“Go Live”按钮重新触发）。
- 不要填
0：虽然部分扩展支持0表示“随机端口”，但 Live Server 不认，会报错Invalid port number - 避免用
1024以下端口（如80、443），普通用户权限无法绑定，会静默失败或报EACCES - 如果改了端口后页面 404，检查是不是 HTML 文件没保存，或者 Live Server 没真正重启（看右下角状态栏文字是否更新）
远程开发（Remote-SSH / Containers）连不上，真是端口问题吗？
90% 的情况不是端口被改，而是连接链路断在某一层：本地 SSH 客户端连不到远程服务器的 22 端口、远程服务器没装 vscode-server、或防火墙拦了反向隧道端口（如 40001–40010）。VS Code Remote 用的是动态端口协商，不是固定一个端口。
- 检查远程服务器上
~/.vscode-server目录是否存在，缺失就重装（删除后重连会自动拉取） - 如果用非标准 SSH 端口（比如
2222），确保ssh_config里写了Port 2222，而不是只改了 VS Code 设置里的remote.ssh.defaultExtensions - 遇到
Could not establish connection to …且日志里有connect ECONNREFUSED 127.0.0.1:40001，说明本地转发失败，可能杀毒软件或代理劫持了 localhost 流量
为什么改了设置还是用旧端口？
VS Code 设置分层级：用户级、工作区级、远程级。如果你在工作区里改了 liveServer.settings.port，但当前没打开文件夹（即处于空窗口），设置不会生效；反过来，如果在远程容器里改了，本地窗口也看不到这个值。
- 确认设置生效范围：看设置项右侧是否有
Workspace或Remote [devcontainer]标签 - 改完别忘了重载窗口（
Cmd+Shift+P→Developer: Reload Window），尤其改了远程相关配置后 - 某些扩展（如 Debugger for Chrome）的端口是硬编码在 launch.json 里的，得去
.vscode/launch.json改port字段，不是改设置
端口问题从来不是改一个数字就能解决的，关键在定位实际使用者和作用域。很多人卡在“以为改了 VS Code 本身”，结果折腾半天发现是另一个后台 Node 进程占着 3000 没关。
