网站SVG Logo修改后消失问题求助及代码排查

学习素材中的Logo显示正常，但修改原logo.svg文件内的图像内容后，Logo就消失了，已尝试网络搜索解决方案但无效。原Logo显示效果：

我的HTML代码 #

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
    <link rel="stylesheet" href="css/main.css">
    <script src="js/app.js" defer></script>
    <script src="libs/rain.js" defer></script>
</head>
<body>

    <div class="logo" style="background-image: url(/img/logo.svg);"></div>

    <section class="layers">
        <div class="layers__container">
            <div class="layers__item layer-1" style="background-image: url(/img/layer-1.jpg);"></div>
            <div class="layers__item layer-2">
                <div class="hero-content">
                    <h1>Red Maple Leaf<span>Studios</span></h1>
                    <div class="hero-content__p">Creating a beautiful 3D website with a ‘lens effect’</div>
                    <button class="button-start">Exlore music</button>
                </div>
            </div>
            <div class="layers__item layer-4">
                <canvas class="rain"></canvas>
            </div>
            <div class="layers__item layer-5" style="background-image: url(img/layer-5.png);"></div>
        </div>
    </section>

</body>
</html>

我的CSS代码 #

* {
    margin: 0;
    padding: 0;
    box-sizing: border-box;
}
:root {
    --index: calc(1vw + 1vh);
    --transition: 1.5s cubic-bezier(.05, .5, 0, 1);
}
@font-face {
    font-family: kamerik-3d;
    src: url(../fonts/kamerik205-heavy.woff2);
    font-weight: 900;
}
@font-face {
    font-family: merriweather-italic-3d;
    src: url(../fonts/merriweather-regular-italic.woff2);
}
body {
    background-color: #000;
    color: #7c222a;
    font-family: kamerik-3d;
}
.logo {
    --logo-size: calc(var(--index) * 7.8);
    width: var(--logo-size);
    height: var(--logo-size);
    background-repeat: no-repeat;
    position: absolute;
    left: calc(51% - calc(var(--logo-size) / 2));
    top: calc(var(--index) * 2.8);
    z-index: 1;
}
.layers {
    perspective: 1000px;
    overflow: hidden;
}
.layers__container {
    height: 100vh;
    min-height: 500px;
    transform-style: preserve-3d;
    transform: rotateX(var(--move-y)) rotateY(var(--move-x));
    will-change: transform;
    transition: transform var(--transition);
}
.layers__item {
    position: absolute;
    inset: -5vw;
    background-size: cover;
    background-position: center;
    display: flex;
    align-items: center;
    justify-content: center;
}
.layer-1 {
    transform: translateZ(-55px) scale(1.06);
}
.layer-5 {
    transform: translateZ(300px) scale(.9);
}

.hero-content {
    font-size: calc(var(--index) * 2.9);
    text-align: center;
    text-transform: uppercase;
    letter-spacing: calc(var(--index) * -.15);
    line-height: 1.35em;
    margin-top: calc(var(--index) * 5.5);
}
.hero-content span {
    display: block;
}
.hero-content__p {
    text-transform: none;
    font-family: merriweather-italic-3d;
    letter-spacing: normal;
    font-size: calc(var(--index) * .73);
    line-height: 3;
}
.button-start {
    font-family: Arial;
    font-weight: 600;
    text-transform: uppercase;
    font-size: calc(var(--index) * .71);
    letter-spacing: -.02vw;
    padding: calc(var(--index) * .7) calc(var(--index) * 1.25);
    background-color: transparent;
    color: #7c222a;
    border-radius: 10em;
    border:#7c222a (255 255 255 / .4) 3px solid;
    outline: none;
    cursor: pointer;
    margin-top: calc(var(--index) * 2.5);
}
.layer-4, .layer-5 {
    pointer-events: none;
}

排查与解决方案 #

一、确认问题根源 #

你的HTML和CSS代码逻辑无明显错误，优先排查修改后的logo.svg文件：

• 将修改前的原始SVG文件放回原位置，若能正常显示，说明问题完全出在修改后的SVG文件上。

二、SVG文件常见问题修复 #

1. 语法错误
   修改时误删关键标签（如<svg>根标签、闭合标签）或写错属性，导致浏览器无法解析。

• 修复：用浏览器直接打开修改后的SVG，若无法显示，检查代码：
  • 确保存在完整的<svg>根标签，例如：<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">
  • 所有标签正确闭合，无遗漏的结束标签。

2. viewBox设置错误
   修改图形后未同步调整viewBox，导致图形超出可视区域，视觉上消失。

• 修复：检查viewBox属性，确保其范围覆盖所有图形元素。例如图形范围是x0,y0到x200,y200，设置viewBox="0 0 200 200"。

3. 编码问题
   保存SVG时使用了非UTF-8编码，导致解析失败。

• 修复：用VS Code等编辑器打开SVG，选择UTF-8编码重新保存。

4. 路径/文件名问题
   修改SVG后可能误移文件位置，或文件名大小写与HTML中引用不一致（部分服务器区分大小写）。

• 修复：确认HTML中url(/img/logo.svg)的路径、文件名与实际文件完全匹配。

三、代码层面补充调整（若SVG文件确认无误） #

1. 给.logo添加背景适配属性，确保SVG正确显示：

.logo {
    --logo-size: calc(var(--index) * 7.8);
    width: var(--logo-size);
    height: var(--logo-size);
    background-repeat: no-repeat;
    background-size: contain; /* 新增：适配容器 */
    background-position: center; /* 新增：居中显示 */
    position: absolute;
    left: calc(51% - calc(var(--logo-size) / 2));
    top: calc(var(--index) * 2.8);
    z-index: 1;
}

2. 内嵌SVG到HTML，替代背景图，便于直接排查解析问题：

<div class="logo">
    <!-- 替换为你的SVG代码 -->
    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200">
        <path d="..."></path>
    </svg>
</div>

同时添加CSS样式：

.logo svg {
    width: 100%;
    height: 100%;
}

内容的提问来源于stack exchange，提问作者nas2toll