30-Days-Of-JavaScript/js_notes/README.md

📚 我的 JavaScript 学习笔记

跟着 30-Days-Of-JavaScript 教程学,但按知识体系整理,方便日后复习。 开始于 2026-07。

---

🧭 怎么用这个目录

• 每个主题就是根目录下一个 编号-主题.js 单文件(如 08-sets-maps.js), 学练复习一体,内含三段:
  1. 概念总结区(文件顶部注释,含 ASCII 表格)—— 复习先看这里
  2. 示范区 —— 带预期输出的可运行代码
  3. 轮到你区 —— 练习题,只给要求不给答案 用 // ═════ 概念总结 ═════ / // ═════ 示范 ═════ / // ═════ 轮到你 ═════ 分隔。
• 编号(01-, 02-…)只表示推荐学习顺序,不是"第几天"
• 例外:00-concepts/ 仍是文件夹(跨主题通用概念一组,多为 .md)

📌 结构演变:早期用 NN-topic/(内含 notes.md+practice.js)分开两文件, 现已扁平化为根目录单文件 NN-topic.js(概念写进代码注释),减少重复、复习更快。

运行代码的三种方式

方式	怎么做	适合
Quokka(免费版)	Cmd+Shift+P → Quokka: Start on Current File	边写边看 console.log 的值(纯逻辑练习)
Code Runner ▷	右上角 ▷,或 Ctrl+Alt+N	在终端跑整个文件
浏览器 + F12	打开 index.html,看 Console	涉及 document/DOM 的代码

⚠️ 判断能不能用 ▷/Quokka 跑:文件自包含(自己定义自己用、无 document)就能跑; 依赖别的文件的变量、或含 document 的,要用浏览器。

---

🗺️ 知识地图(带进度)

〇、通用概念(跨主题,随时查)

• 00-concepts/my-mistakes.md —— 🕳️ 我的踩坑记录(复习先看这个!含报错秒查表)⭐
• 00-concepts/call-forms.md —— 三种调用形式:值.方法() vs 函数() vs 类.方法()
• 00-concepts/value-vs-reference.md —— 值 vs 引用:复制 vs 共享、字符串不可变 ⭐
• 00-concepts/shortcircuit-bash-vs-js.md —— &&/||:bash vs JS(0 真假相反)
• 00-concepts/semicolons-and-asi.md —— 分号 ; 什么时候【必须】写(ASI 的坑:行首 (/[、return 换行)⭐

一、基础与数据

• 01-basics 基础:输出、注释、表达式、字符串引号、运行方式
• 02-variables 变量与数据类型
• 03-operators 运算符
• 04-strings 字符串(常用方法)
• 05-conditionals 条件与布尔

二、数据结构

• 06-arrays 数组
• 07-objects 对象
• 08-sets-maps Set 与 Map

🎯 本路线已为目标「用 pi 搭 agent + 读懂 pi 关键源码」做过适配: 异步大幅提前(agent 命脉)、新增模块与 TS 专题、前端相关暂缓。原教程的 day 顺序仅作参考。

三、逻辑与函数(pi 前置 · 核心)

• 09-loops 循环
• 10-functions 函数(声明/表达式、箭头、参数、返回、作用域)
• 11-higher-order-functions 高阶函数 + 回调(map / filter / reduce)← 读 TS 必备
• 12-destructuring-spread 解构与展开 ← pi 源码里到处是,读代码前置
• 13-closures 闭包(理解 agent 状态、回调捕获)

四、异步与工程结构(agent 的命脉)⭐

• 14-modules 模块 import / export ← 新增:monorepo/多包的地基
• 15-promises-async 异步 Promise / async-await ← 从原第18提前!每个 LLM 调用都是异步
• 16-error-handling 错误处理 try/catch ← 和 await 搭配
• 17-classes 类 class ← agent 运行时/状态管理常用
• 18-json JSON ← LLM 的输入输出、tool calling 都是 JSON

五、TypeScript(看懂 pi 的门票)⭐

• 19-ts-basics TS 基础:为什么要类型、类型标注、interface / type
• 20-ts-generics 泛型 <T>、联合类型、如何读懂函数签名
• 21-ts-project 工程:模块类型、tsconfig、怎么读 .d.ts 和别人的类型

六、Agent 领域 + pi 实战

• 22-agent-concepts 领域概念:LLM API、tool calling、agent loop 是什么
• 23-pi-hello 用 pi 搭一个最小可跑的 agent
• 24-pi-source-reading 精读 pi 源码(挑软柿子,逐行带读,不求全懂)

附:暂缓(和 pi 无关,想做前端再回来)

• 正则表达式 / DOM 操作 / 事件监听 / Web Storage / 综合前端项目

---

📏 练习规矩(给协作者/AI)

• 练习题让用户自己改,不要替他写答案。
• 出题不写答案:"轮到你"区域只给要求,不放正确答案(哪怕注释掉也不行,会剧透)。
• 提示只给方向,不给完整写法:如 raw.trim().toLowerCase() 这种整句提示等于给答案,不行; 应改成"两个方法可以链式连写"这种点思路的说法。
• 示范区(讲解用的例子)可带预期输出;题目区不带。
• 用户每犯一个新错,吸收进 00-concepts/my-mistakes.md(错法→现象→正解→教训), 并带 📍来源索引(原题文件+练习号、相关笔记章节),方便跳回原题。复习时才记得住坑在哪。

✍️ 命名约定

• 文件夹:编号-英文主题,如 06-arrays
• 笔记:notes.md;练习:practice.js
• 一个主题内容多时,练习可拆成 practice_01_xxx.js 等