VSCode的Port Forwarding无法用于本地项目公网分享，因其仅支持SSH -L单向隧道（本地→远程），无法实现反向穿透；需用cpolar等工具将本地服务端口映射为公网HTTPS URL。
VSCode 本身不支持直接把本地项目暴露到公网，Port Forwarding 只是单向隧道（远程→本地），不能反向穿透。要实现“本地项目公网预览”，必须引入第三方工具如 cpolar、ngrok 或 localtunnel。
为什么 VSCode 的 Port Forwarding 无法用于本地项目公网分享
VSCode Remote-SSH 的 Forward a Port… 功能本质是 SSH -L 参数：它只允许「从本地发起、经 SSH 隧道打到远程」的流量。也就是说，它解决的是「我在本地访问远程服务」的问题，不是「让别人通过公网 URL 访问我本地的服务」。
- 你本地启动了
npm run dev（监听127.0.0.1:3000），VSCode 的端口转发对它完全无感知——因为没连远程服务器 - 即使你强行在本地用
ssh -R做远程端口转发，也需要一台有公网 IP 的中转服务器，且配置复杂、不稳定 - 浏览器访问
http://localhost:3000是本地回环，公网用户根本拿不到这个地址
用 cpolar 实现本地项目一键公网预览（VSCode 内集成）
真正可行的路径是：在本地开发环境（VSCode + Live Server / Vite / Next 等）基础上，用 cpolar 把本地服务端口（如 5500 或 3000）映射成一个公网 HTTPS URL。
- 先安装
cpolar（官网下载或brew install cpolar/choco install cpolar） - 确保本地服务已启动并监听
127.0.0.1（不是localhost，部分框架需加--host 127.0.0.1） - 终端执行：
cpolar http 5500（假设 Live Server 默认端口为5500） - 输出类似
https://abc123.cpolar.io—— 这就是可分享的公网地址 - 可在 VSCode 中配置任务（
.vscode/tasks.json）一键拉起："command": "cpolar", "args": ["http", "5500"]
常见失败点：浏览器拒绝连接或白屏
即使 cpolar 成功返回 URL，打开后空白或报错，大概率是本地服务未正确响应跨域请求或 host 绑定问题：
- Live Server 默认只响应
localhost请求，需在settings.json中加："liveServer.settings.CustomBrowser": "chrome"并确认 Chrome 没启用 strict localhost policy（v120+ 可能拦截非标端口） - Vite 项目必须设
server.host: '127.0.0.1'且server.strictPort: false，否则cpolar流量进不来 - Next.js 开发模式默认禁止外部访问，启动时加
next dev --host 127.0.0.1 - 如果页面内有硬编码的
http://localhost:3000/api/...请求，公网访问时会跨域失败，需配env.development或代理
别混淆「Remote-SSH 端口转发」和「本地服务公网暴露」
这两个场景技术路径完全不同，但新手极易混用：
- Remote-SSH Port Forwarding → 你连服务器，想看它上面跑的
python -m http.server→ 用 VSCode UI 点一下就行 - 本地项目公网预览 → 你在本机写代码，想让客户扫码看 → 必须用
cpolar/ngrok，VSCode 只负责启动服务和调用命令 - 有人试图在本地用
ssh -R 80:localhost:3000 user@vps，这要求你有可控 VPS，还要配 DNS、HTTPS、反代，远不如cpolar一行命令干净
最易被忽略的一点：所有公网暴露工具（包括 cpolar）都依赖本地服务「明确监听 127.0.0.1」，而不是 localhost 或 0.0.0.0 —— 后者在某些系统上会被解析为 IPv6 地址或触发安全策略，导致隧道连通但服务无响应。
