朋友做的网站图片不显示不出来，这问题看着小，真搞起来能让人头秃。昨天半夜两点，我哥们儿老张给我打电话，声音都颤了，说刚上线的网站全是红叉，客户那边骂声一片。我心想，这哪是建站，这是建雷啊。

咱干这行的都知道，建站容易，排雷难。老张那网站是用某免费模板搭的，看着挺花哨，结果一上线，除了文字，其他啥也看不见。他急得直拍大腿，问我是不是服务器被黑了。我让他把链接发我，打开一看，好家伙，满屏的404。

这种情况，十有八九是路径问题。很多人建站的时候，习惯在本地用相对路径，比如。这在本地测试没问题，因为文件都在一个文件夹里。但一旦上传到服务器，如果目录结构稍微有点变化，或者服务器对路径大小写敏感，这图片就找不着北了。老张就是栽在这上面，他本地是Windows，服务器是Linux，大小写不匹配，直接GG。

还有一个常见坑，就是图片格式不支持。有些老式服务器或者配置不严的虚拟主机，对WebP这种新格式支持不好，或者干脆没装解码插件。老张为了追求加载速度，把图片全转成了WebP，结果浏览器解析失败，直接显示空白。这时候，你 inspect 元素看一眼网络请求，状态码如果是403或者404，基本就能定位问题了。

当然，也有可能是CDN配置背锅。现在大家都喜欢用CDN加速，但CDN的缓存规则要是没设对，比如把图片后缀误判为静态资源却加了错误的缓存头，或者源站返回了错误状态码，CDN就会把错误缓存下来。这时候，你刷新本地页面没用，得去CDN控制台强制刷新缓存，或者清一下浏览器缓存。

我让老张别急，先别改代码，先检查图片URL能不能直接在浏览器新标签页打开。能打开，说明图片本身没问题，是网站引用路径错了；打不开，那就是图片文件根本没传上去，或者权限不对。结果你猜怎么着？老张上传图片的时候，文件名里带了空格！在Windows里没问题，但在Linux服务器里，空格会被转义成%20，导致链接断裂。这破事儿，真让人哭笑不得。

解决完路径问题，老张又遇到了另一个麻烦，图片显示不全。原来是他用的CSS样式里，给图片容器设了固定高度，但图片比例不对，导致被裁剪。这时候，得用object-fit: cover;或者auto，让图片自适应。

其实，朋友做的网站图片不显示不出来，很多时候不是技术有多高深，而是细节没做到位。建站这事儿，就像绣花，针脚密不密，全看用心不用心。别信那些“一键生成”的鬼话，真正的稳定，是靠一遍遍测试出来的。

最后提醒一句，上线前，一定要用不同浏览器、不同设备测试。别等客户投诉了才想起来检查。我这人说话直，但都是血泪教训。老张那网站修好后，他请我吃了顿烧烤，边吃边说，以后再也不偷懒了。我也就图个心安，毕竟谁的钱都不是大风刮来的，网站是脸面，不能丢人。

要是你也遇到类似问题，别慌，先抓包，看请求，看路径，看权限。一步步来，总能搞定。记住，细节决定成败，这话虽然老套，但真管用。