首页
/ 正文

HTML script src 属性（一文讲透）

更新时间: 2025-04-05 07:49:29

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;

《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前，星球内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习，欢迎点击围观

在网页开发中，HTML 是构建页面结构的基础语言，而 JavaScript 则赋予了网页动态交互的能力。将 JavaScript 代码嵌入 HTML 文档时，script 标签的 src 属性是一个关键角色。它如同网页与外部资源之间的“导航员”，负责定位并加载外部 JavaScript 文件。无论是初学者还是中级开发者，理解 HTML script src 属性 的工作原理和最佳实践，都能显著提升代码的可维护性和网页性能。本文将从基础概念、使用场景、高级技巧到常见问题，系统性地解析这一核心知识点。

一、HTML Script 标签与 src 属性的基础概念

1.1 HTML Script 标签的双重角色

<script> 标签在 HTML 中有两种主要用途：

内联脚本：直接在标签内编写 JavaScript 代码（例如 <script>alert('Hello!');</script>）。
外部脚本：通过 src 属性指向外部 JavaScript 文件（例如 <script src="script.js"></script>）。

其中，src 属性是实现外部脚本加载的核心。它的英文全称是 source，即“来源”，表示需要加载的资源路径。

1.2 类比理解：src 属性如同快递地址

想象你网购了一本《JavaScript 入门指南》，商家需要知道你的收货地址才能寄送书籍。类似地，src 属性就是开发者为浏览器提供的“地址”，告诉它去哪里获取 JavaScript 文件。无论是本地文件路径还是远程服务器地址，src 都是资源定位的唯一标识。

二、src 属性的语法与基本用法

2.1 基础语法结构

<script src="relative/path/to/file.js"></script>
或
<script src="https://example.com/path/to/file.js"></script>

关键点说明：

路径类型：支持相对路径（相对于当前 HTML 文件）或绝对路径（完整 URL）。
文件扩展名：通常以 .js 为后缀，但并非强制要求。
属性位置：src 属性必须位于 <script> 标签内，且与其他属性（如 async、defer）无冲突。

2.2 实例演示：加载外部脚本

假设 HTML 文件与 script.js 在同一目录下，代码如下：

<!DOCTYPE html>  
<html>  
<head>  
    <title>Script Demo</title>  
</head>  
<body>  
    <h1>欢迎学习 HTML script src 属性</h1>  
    <!-- 加载外部 JavaScript 文件 -->  
    <script src="script.js"></script>  
</body>  
</html>

在 script.js 中可以编写：

document.write("脚本已加载成功！");

运行后，页面会显示“脚本已加载成功！”的文本，证明外部脚本通过 src 属性被正确引入。

三、src 属性的加载机制与性能影响

3.1 同步加载：默认行为的“阻塞”特性

当浏览器解析到 <script> 标签时，默认会暂停 HTML 的解析，直到脚本下载并执行完毕。这种机制称为 同步加载。

类比场景：
想象你正在阅读一本小说，突然遇到一个需要参考百科全书的术语。你必须放下小说，找到百科全书查阅相关内容，再继续阅读。同步加载就类似这个过程，浏览器必须等待脚本完成才能继续渲染页面。

3.2 解决方案：异步与延迟加载

为优化性能，开发者可通过 async 和 defer 属性控制脚本加载方式：

3.2.1 async 属性

作用：让脚本异步加载，不阻塞页面渲染，但执行顺序可能与加载顺序无关。
适用场景：独立脚本（如统计代码），与其他脚本无依赖关系。

示例：

<script src="analytics.js" async></script>

3.2.2 defer 属性

作用：延迟脚本执行，直到 HTML 解析完成，且按加载顺序执行。
适用场景：需要按顺序执行的脚本（如模块化代码）。

示例：

<script src="module1.js" defer></script>  
<script src="module2.js" defer></script>

3.3 性能对比表格

属性	加载方式	执行时机	是否阻塞渲染	执行顺序
无	同步	立即	是	严格顺序
async	异步	下载完成	否	随机顺序
defer	异步	DOM 完成	否	加载顺序

四、src 属性的进阶用法与最佳实践

4.1 动态加载脚本：使用 JavaScript 创建 script 标签

有时需要根据条件动态加载脚本，可通过以下代码实现：

const script = document.createElement('script');  
script.src = 'dynamic-script.js';  
script.async = true;  
document.body.appendChild(script);

这种方法常用于 代码分割 或 按需加载，减少初始加载时间。

4.2 跨域脚本加载与 CORS

当从其他域名加载脚本时，需确保服务器配置了 CORS（跨域资源共享） 头。例如，服务器需在响应头中包含：

Access-Control-Allow-Origin: *

否则浏览器会因安全策略拒绝加载脚本。

4.3 脚本加载失败的处理

通过 onerror 属性或 JavaScript 监听事件，可捕获加载失败的情况：

<script src="missing.js" onerror="handleError()"></script>

配合备用方案（如回退到本地脚本），提升健壮性。

五、常见问题与解决方案

5.1 问题：脚本未加载，页面无反应

可能原因及解决方法：

路径错误：检查 src 路径是否正确，可通过浏览器开发者工具（F12）的 Network 面板查看请求状态。
依赖顺序问题：若脚本依赖其他库（如 jQuery），需确保先加载基础库。

5.2 问题：脚本阻塞页面渲染

优化建议：

将非关键脚本（如广告代码）放在页面底部，或使用 async/defer。
合并多个小脚本为一个文件，减少 HTTP 请求。

5.3 问题：动态内容与静态脚本的冲突

解决方案：

使用事件监听或 DOMContentLoaded 事件，确保 DOM 完全加载后再执行操作：

document.addEventListener('DOMContentLoaded', function() {  
    // 安全操作 DOM  
});

六、实际案例：构建一个动态网页

6.1 需求分析

创建一个包含动态天气查询功能的网页，需加载以下资源：

本地样式表 styles.css。
第三方天气 API 的 JavaScript SDK（需异步加载）。
本地业务逻辑脚本 main.js（依赖天气 SDK）。

6.2 实现代码

<!DOCTYPE html>  
<html>  
<head>  
    <title>动态天气查询</title>  
    <!-- 加载样式表 -->  
    <link rel="stylesheet" href="styles.css">  
    <!-- 异步加载第三方 SDK -->  
    <script src="https://api.weather.com/sdk.js" async></script>  
</head>  
<body>  
    <input type="text" id="cityInput" placeholder="输入城市名">  
    <button onclick="fetchWeather()">查询</button>  
    <div id="weatherResult"></div>  

    <!-- 延迟加载本地脚本，确保 DOM 完成 -->  
    <script src="main.js" defer></script>  
</body>  
</html>

6.3 代码逻辑说明

第三方 SDK 使用 async 避免阻塞页面加载。
本地脚本 通过 defer 确保 DOM 可用后再执行。
fetchWeather() 函数在 main.js 中实现，调用 SDK 提供的 API。

结论

HTML script src 属性 是连接 HTML 静态结构与 JavaScript 动态功能的桥梁。通过合理使用 src 属性及其相关技术（如 async、defer），开发者既能保证代码的模块化和可维护性，又能优化网页性能。无论是初学者构建第一个交互页面，还是中级开发者优化复杂应用，掌握这一知识点都是迈向专业前端开发的关键一步。

后续学习建议：

深入学习 JavaScript 模块化（ES6 Modules）。
探索 Webpack 等工具实现代码打包与优化。
实践服务端渲染（SSR）与静态资源管理策略。

通过持续实践与优化，开发者能将 HTML script src 属性 的潜力最大化，打造高效、流畅的网页体验。