JavaScript学习应从直接编写可运行的HTML+JS代码开始，如用document.body.innerHTML动态修改页面内容，而非陷入环境配置；变量声明优先用const，函数设计需支持灵活参数，DOM操作应面向真实场景。
JavaScript 不是靠“开始学习教程”启动的，而是靠立刻写第一行可运行的代码启动的。别找“最全入门教程”，先让浏览器弹出一个 alert("Hello")，再决定要不要继续。
从哪行代码开始写？不是 console.log，是直接改 HTML
新手常卡在环境搭建：装 Node、配 VS Code、学 npm……其实你只需要一个文本编辑器 + 任意浏览器。
新建 index.html，写进去：
<!DOCTYPE html>
<html>
<body>
<script>
document.body.innerHTML = "<h1>我刚写了 JS</h1>";
</script>
</body>
</html>
双击打开——内容就出来了。这比 console.log 更真实，因为你立刻看到 JS 是怎么和页面互动的。
容易踩的坑：
• 把 <script></script> 放在 里却操作 document.body → 报错 Cannot set property 'innerHTML' of null
• 用单引号包裹 HTML 字符串时，里面又嵌套单引号 → 语法错误，改用双引号或模板字面量
let、const、var 到底什么时候用？
别背定义，看行为：
• var 会变量提升且函数作用域 → 容易意外覆盖，新项目里基本不用
• let 可重新赋值，块级作用域 → 适合循环计数器、临时中间值
• const 声明后不能重新赋值 → 90% 的变量该用它（包括对象和数组，只是不能重指向）
常见错误：
• const user = { name: "Alice" }; user = { name: "Bob" }; → 报错，因为重赋值了
• const user = { name: "Alice" }; user.name = "Bob"; → 合法，没重赋值，只改属性
• for (var i = 0; i console.log(i), 0); → 全输出 3，用 let 就输出 0/1/2
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
函数怎么才算“会写了”？能拆出三个参数就算过关
别写“求两数之和”这种玩具函数。真实场景里，函数必须处理不确定输入：
• 第一个参数：主数据（比如 users 数组）
• 第二个参数：筛选条件（比如 status === "active"）
• 第三个参数：可选配置（比如 { limit: 10, sortBy: "name" }）
示例：function filterUsers(users, condition, options = {}) { ... }
这样写出来的函数才可能被复用。
性能影响：
• 条件逻辑写死在函数体里 → 每次改都要动源码
• 用回调函数传入条件（如 filterUsers(users, u => u.age > 18)）→ 灵活但要注意闭包内存占用
• 配置项用解构默认值 → 避免 options.limit || 10 这种冗余判断
立即学习“Java免费学习笔记（深入）”；
DOM 操作卡住？先忘掉 getElementById
它太窄了。实际开发中你面对的是：
• 一堆同类按钮，要绑定点击事件 → 用 document.querySelectorAll(".btn") + forEach
• 点击某个列表项，要知道点的是第几个 → 用事件委托：list.addEventListener("click", e => { if (e.target.matches("li")) { ... } })
• 表单提交前校验 → 监听 submit 事件，调用 e.preventDefault() 阻止跳转
容易忽略的细节：
• querySelector 找不到元素返回 null，直接链式调用 .addEventListener 会报错 → 先判空或用可选链 ?.addEventListener
• 修改 innerHTML 会销毁已有绑定的事件监听器 → 改用 textContent 或 insertAdjacentHTML
