http //localhost 5173的品牌故事
一个地址，一台电脑，一个刚打开浏览器的深夜。我们把关于它的启动、端口和排错，一条条写清楚。
01 / 我们是谁
从一个打不开的地址开始
很多故事的开头并不体面。我们的开头，是一个卡在转圈的浏览器标签。
那大概是三年前的秋天，办公室只剩两排灯还亮着。有人盯着屏幕，地址栏里写着 http //localhost 5173，页面白得像一张没写字的纸。终端里服务明明已经跑起来了，浏览器却说连不上。后来发现，只是端口被别的程序占了，换一行配置就好——但当时没人告诉他这一点，他翻了四十分钟的搜索页。
localhost5173.cn 就是从这类时刻长出来的。它不生产框架，也不发开发工具；它只做一件事：把围绕 http //localhost 5173 这个本地地址的常见问题——它是什么、为什么打不开、端口怎么改、host 绑定意味着什么——整理成能顺着读下去的文字。我们希望你下次遇到白屏时，花三分钟而不是四十分钟。
站点由一个小编辑组维护，成员都写过前端、都调过端口、也都在凌晨两点改过配置文件。我们不摆权威姿态，只把踩过的坑摊开写清楚。你读到的每一条排查思路，基本都对应某个真实发生过的手忙脚乱。
「地址栏里那串字符不是网址，是你和自己机器之间的一句悄悄话。」 —— 编辑组内部常说的一句话
我们怎样挑选要写的内容
标准朴素：自己或读者真的会卡住的地方才写。端口冲突、服务没起来、host 设成局域网后手机访问不到、改了端口却忘了同步地址——这些高频卡点排在最前。至于某个具体依赖的版本行为，我们尽量写「以官方文档为准」，不把一时一地的输出当成通用规律。
如果你在这里没找到答案，也请相信这可能是我们还没遇到过的坑，而不是你问错了问题。
02 / 使命与理念
三件我们愿意一直坚持的事
让人少绕路
围绕 http //localhost 5173 的问题，按「现象—原因—下一步」写，不铺垫、不绕圈。你要的是能动手的那一句。
不臆造细节
无法核实的报错原文、具体版本号、第三方数据，我们不补、不猜。信息还没确认时保持空缺，比编一个像样的答案更诚实。
只做说明与导航
本站托管任何文件、不代理任何流媒体、不提供盗版或破解路径。我们只解释地址与机制，不做搬运。
03 / 规模与更新
一些好核对的小数字
我们不给数字加光环，只描述本站自身的积累。它们不代表任何第三方背书，也不含无法查证的外部数据。
以上数字仅用于描述本站自身的内容规模与更新频率，不含任何外部排名、评奖或可被第三方核验的背书数据。
04 / 精选条目
最近被反复翻开的几条
这些是我们认为最值得先读的入口。想看具体展开，顺着跳到深度解读或常见问题即可。
- 【避坑指南】改了端口却忘了改地址，是最常见的白屏原因 配置里换了个数字，浏览器里那串地址还停在旧端口，页面自然一片空白。
- 【新手必看】localhost 和 127.0.0.1 到底是不是一回事 本机回环地址的两种写法，日常混用无碍，但在绑定和跨设备访问时会显出差异。
- 【深度盘点】端口被占用之后，能动手解决的几条路 换端口、停进程、查占用，三条路径各有代价，按你的场景挑一条最省事的。
- 【热门精选】手机连不上本地页面，问题多半出在 host 绑定 服务只监听本机时，同局域网的手机看不到它，绑定到局域网地址才能通。
05 / 深度解读
把地址打开之前，先弄懂这几步
http //localhost 5173 这串字符其实分三段读：http 是协议，localhost 指的是运行服务的那台机器本身，5173 是端口号——很多前端开发工具默认就监听这个端口。看懂这三段，大半的「打不开」就有了解释的起点。
真正的门道在于：地址能不能打开，取决于三件事同时成立——服务在跑、端口对得上、请求被允许进来。任何一环断了，页面都只会给你一张白纸。下面把排查拆成分步，失败后该转去哪一步也一并写明。
- 先确认服务确实启动了终端有没有正常输出监听提示，进程有没有意外退出。
- 核对端口是否一致配置里写的端口和地址栏里的数字，必须是同一个。
- 检查 host 绑定范围只绑本机时，别的设备看不见你；要跨设备访问就得放开范围。
- 排除占用与缓存端口可能被别的程序占了；浏览器缓存也可能让你看到旧结果。
- 记录并反馈卡点把看到的提示原文记下来，找不到原因时按邮箱反馈给我们。
| 步骤 | 核心动作 | 失败时的下一步 |
|---|---|---|
| 第 1 步 | 看终端是否输出监听成功的提示，服务进程是否还活着。 | 进程已退出就重新启动；启动报错，转第 4 步查占用。 |
| 第 2 步 | 把配置里的端口和地址栏里的数字逐位比对。 | 不一致就改配置或改地址，改完刷新重试。 |
| 第 3 步 | 确认 host 绑定是仅本机还是包含局域网。 | 手机等其它设备访问不到，转到第 3 步放开绑定范围。 |
| 第 4 步 | 检查端口是否被其它程序占用，必要时换一个端口。 | 换完仍不通，清浏览器缓存后重试，再不行转第 5 步。 |
| 第 5 步 | 记录完整提示原文与你的操作顺序，按邮箱反馈。 | 等待回复期间，可先读下方的常见问题找相近情形。 |
三类最常见的误区
误区一：把它当成公网网址。有人在别的电脑上敲同一个地址，发现打不开就以为站点坏了。其实 localhost 只对「运行服务的那台机器」有意义，换台机器，它指向的就是另一台设备。
误区二：以为改端口只改一处。端口往往同时出现在配置、启动命令和浏览器地址里。改了一处漏了另一处，表现就是「明明改了还是白屏」。养成改完顺手核对三处的习惯。
误区三：把浏览器缓存当成服务故障。有时候服务好好的，只是浏览器还记着上一次的失败结果。强制刷新或换无痕窗口，几秒钟就能证伪这个怀疑。
还有一条编辑态度写在前面：不同开发工具的默认行为会随版本变化，我们无法替你确认某个具体版本的确切输出。碰到与本文描述不符的地方，以官方文档为准，也欢迎按投诉与举报邮箱告诉我们，核实后更正文案。
06 / 常见问题
你可能想问的四个问题
http //localhost 5173 到底是什么？是一个能打开的网站吗？
它不是一个对全网开放的站点，而是本地开发服务器常用的默认访问地址：localhost 指你正在使用的这台电脑，5173 是开发工具默认监听的端口号。你在终端里启动一个前端项目后，浏览器输入这个地址，看到的其实是本机跑起来的页面。本站围绕它整理启动步骤、端口含义与排查思路，你可以从页面下方的深度解读开始读。
打开这个地址安全吗？会不会泄露我的信息？
因为这个地址指向你自己机器上的服务，流量不出本机，正常情况下不经过公网。需要注意两点：一是把服务绑定到局域网或对外网开放时要谨慎，局域网内其他设备就能访问到你的页面；二是不要在这个地址下填入来源不明的账号密码。本站只做说明与导航，不采集你的本地环境信息，也不提供任何下载包。
访问不了怎么办？要注册或登录本站吗？
本站不需要注册登录，所有说明页面直接可读。地址打不开时，先确认开发服务是否真的在运行，再看端口是否被占用或改过，最后检查是否绑定了只允许本机访问的 host。具体的分步对照和失败后转去哪一步，写在「把地址打开之前，先弄懂这几步」那张表里，顺着表格走一般能定位到卡点。
本站和官方文档、开发工具是什么关系？多久更新一次？
本站是独立的第三方信息整理站，不是任何开发工具或框架的官方站点，内容依据公开文档与常见排错经验写成。版本迭代快的地方，我们会标注「以官方文档为准」，无法核实的报错原文与具体版本号不臆造。专题时间线大致按月推进，发现描述过时或与你的环境不符，欢迎按内容声明里的邮箱反馈，我们核实后更正文案。
07 / 定位与声明
我们把边界说在前面
一个说明站的可信，不靠口号，靠把「不做什么」讲清楚。以下几条是我们长期遵守的编辑原则。
- 本站是信息导航与内容解析站，围绕 http //localhost 5173 等本地开发地址做说明与整理，不是任何开发工具、框架或平台的官方网站，也不代表其立场。
- 本站不托管、不上传、不代理任何文件、安装包或流媒体内容，不提供盗版、破解或侵权资源的获取路径。
- 页面中的信息来源于公开文档与常见排错经验，版权归原作者；引用处尽量标注来源，涉及具体版本行为时以官方文档为准。
- 如你认为本站内容侵犯了你的权益，请通过下方的版权与侵权处理邮箱联系，我们承诺在 48 小时内响应并核实处理。
- 内容面向具备基础计算机使用能力的读者；未成年人请在监护人指导下阅读，并避免在本机环境之外随意开放服务端口。
08 / 联系
有话，写信给我们
我们不设在线客服，也不用即时聊天窗口。有事写邮件，落成文字更清楚，也方便我们逐条核对。按事情的性质挑一个邮箱就好。
09 / 延伸阅读