Bootstrap 5.3导航栏Dropdown无法正常工作 求解决方案及示例

必要依赖说明 #

Bootstrap 5.3 的下拉功能依赖以下三个核心文件，引入顺序必须严格遵守：

• Bootstrap 样式文件（bootstrap.min.css）
• Popper.js 核心文件（popper.min.js，Bootstrap 5 所有弹出类组件都依赖它）
• Bootstrap 脚本文件（bootstrap.min.js）

注意：如果只引入了 Bootstrap 的 CSS 和 JS，未添加 Popper.js，下拉功能必然无法正常工作。

完整可运行示例代码 #

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Bootstrap 5.3 导航栏下拉示例</title>
    <!-- 引入 Bootstrap CSS -->
    <link rel="stylesheet" href="本地路径/bootstrap.min.css">
</head>
<body>
    <!-- 导航栏 -->
    <nav class="navbar navbar-expand-lg navbar-dark bg-dark">
        <div class="container-fluid">
            <a class="navbar-brand" href="#">导航栏品牌</a>
            <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNavDropdown" aria-controls="navbarNavDropdown" aria-expanded="false" aria-label="Toggle navigation">
                <span class="navbar-toggler-icon"></span>
            </button>
            <div class="collapse navbar-collapse" id="navbarNavDropdown">
                <ul class="navbar-nav">
                    <li class="nav-item">
                        <a class="nav-link active" aria-current="page" href="#">首页</a>
                    </li>
                    <li class="nav-item">
                        <a class="nav-link" href="#">链接</a>
                    </li>
                    <!-- 下拉菜单 -->
                    <li class="nav-item dropdown">
                        <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
                            下拉菜单
                        </a>
                        <ul class="dropdown-menu">
                            <li><a class="dropdown-item" href="#">菜单项1</a></li>
                            <li><a class="dropdown-item" href="#">菜单项2</a></li>
                            <li><hr class="dropdown-divider"></li>
                            <li><a class="dropdown-item" href="#">分隔后的菜单项</a></li>
                        </ul>
                    </li>
                </ul>
            </div>
        </div>
    </nav>

    <!-- 引入依赖脚本，顺序不能乱 -->
    <script src="本地路径/popper.min.js"></script>
    <script src="本地路径/bootstrap.min.js"></script>
</body>
</html>

常见错误排查 #

• 确认 data-bs-toggle="dropdown" 属性已添加到下拉触发元素上
• 检查脚本引入顺序：Popper.js 必须在 Bootstrap JS 之前
• 确保所有类名拼写正确（比如 dropdown-toggle 不要写错）
• 验证文件路径是否正确，无加载失败情况

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