最常见原因是DOM未加载完成时执行脚本：script放在head中操作body元素，document.getElementById()返回null，导致Cannot read property 'xxx' of null错误；解决方法是将script移至/body前或加defer属性。
直接看浏览器控制台第一行红字报错，绝大多数 script 标签问题不是 HTML 本身错，而是 JS 执行时出的错——要么 DOM 没准备好就去查元素，要么语法写崩了，要么路径错了根本没加载上。
script 放在 head 里却操作 DOM 元素
这是最常触发 TypeError: Cannot read property 'xxx' of null 的场景。浏览器解析到 <script></script> 就立刻执行，但此时 还没开始渲染，document.getElementById("xxx") 必然返回 null。
- 把
<script></script>移到前——最简单、最可靠的做法 - 非要放
，就加defer属性（仅对外部脚本有效，<script src="a.js" defer></script>） -
DOMContentLoaded可用，但别把它当“万能延迟”：它不等图片、字体、CSS 加载完，也不解决多个脚本间的执行顺序 - 别用
document.write()—— 它会清空整个页面，现代开发中已淘汰
console 报 Uncaught SyntaxError 或 ReferenceError
这类错误基本锁定在 JS 语法或变量作用域上，和 HTML 结构无关，但容易被误判为“HTML 错了”。典型表现是控制台红字卡在某一行，点进去看到的是 JS 代码高亮。
-
Uncaught SyntaxError: Unexpected token：引号/括号/花括号没配对，或用了中文标点（如“”、，、。） -
Uncaught ReferenceError: xxx is not defined：变量名拼错、漏声明（let/var/const）、或在函数内定义却在外部调用 - 内联脚本里混入 HTML 注释（如
<!-- comment -->）会导致 JS 解析中断，直接删掉或改用// comment - 检查
<script></script>标签是否意外闭合过早，比如写了<script>console.log(</script>"hello");—— 浏览器在第一个就截断了
script 标签 src 路径 404 或 CORS 报错
控制台 Network 面板里标红的 JS 请求，就是线索。常见于本地双击打开 index.html，或路径写错。
立即学习“前端免费学习笔记（深入）”；
- 用
file:///协议打开时，fetch()、import、type="module"全部被拦截，必须起本地服务（如python3 -m http.server） - 相对路径以
index.html所在目录为基准，不是浏览器地址栏路径。例如 URL 是http://localhost:8000/sub/page.html，那src="js/main.js"就去找/sub/js/main.js -
type="module"下路径必须带扩展名（src="./main.js"），且服务器要返回正确 MIME 类型；否则报Failed to load module script - 检查大小写：Linux/macOS 服务器区分
script.js和Script.js，Windows 不区分，但部署后可能突然失效
HTML 结构问题间接导致 script 失效
浏览器自动修复 DOM 后，你写的元素可能根本不存在于最终结构里，JS 查不到，自然报错。这种问题控制台往往不报错，只显示 null 或空白。
- 打开 Elements 面板，别信源码，看实际渲染出的 DOM 树——如果某
<div id="app"> 在 Elements 里压根没出现，大概率是前面标签没闭合或嵌套非法（比如 <code><p></p> <div></div>） <table> 内部漏写 <code><tbody>，浏览器会自动补，但补的位置可能让 JS 获取的 <code>tr列表错位- 用 W3C Validator 提交源码，重点看
End tag div does not match the start tag p这类提示，它比人眼更准 - VS Code 装
Auto Close Tag插件有帮助，但它对模板字符串里的 HTML 或条件注释无效，不能替代人工核对
真正麻烦的从来不是报错信息本身，而是那些不报错的失效：DOM 没加载完就执行、标签被浏览器悄悄重排、BOM 头让 JS 静默跳过第一行——这些都得靠 Elements 面板和 Network 面板交叉验证，而不是只盯着 Console 红字。
