Things I shipped
and things I learned.

LangGraph 解决的是 LangChain 不擅长的那类问题：需要循环、分支、持久化状态、人工审批的长时运行 Agent。LangChain 的 createAgent 底层就跑在 LangGraph 上，但当你想自己掌控控制流时，需要直接使用 LangGraph 的图 API。

• 适用场景：多步骤 Agent、人在回路、故障恢复、多智能体编排
• 技术栈：@langchain/langgraph（TypeScript 端），Node.js 22+
• 目标：工作流可控制、可恢复、可观测、可生产

本文整理一 LangChain 学习路径：从生态定位与核心概念起步，逐层深入 LCEL 管道、Agent 与中间件、RAG 检索增强，最后给出生产化要点、版本迁移与上线检查清单。所有代码片段使用 Node.js + TypeScript。

• 适用场景：LLM 应用原型、RAG 系统、Agent 工作流、Node 后端 AI 集成
• 技术栈：LangChain 1.x（JavaScript/TypeScript 端），需 Node.js 22+
• 目标：应用能跑、能控、能观测、能生产

本文整理 Vite 学习路径：从核心原理与最小项目起步，逐层深入配置体系、环境变量、插件开发、按需加载、生产构建优化与部署策略，最后给出与 Webpack 的对比选型、常见问题。

• 适用场景：Web / SPA / 微前端 / Electron 渲染层的现代构建
• 技术栈：Vite 7.x，框架无关（Vue / React / Svelte 等均可接入）
• 目标：开发极速、配置简洁、生产可控、迁移平滑

本文整理一条可落地的 Webpack 学习路径：从核心概念与最小配置起步，逐层深入 Loader、Plugin、模块解析、构建性能、产物优化、多环境配置、模块联邦，最后给出迁移建议、常见问题。

• 适用场景：Web / SPA / 微前端 / Electron 渲染层的工程化构建
• 技术栈：Webpack 5，框架无关（Vue / React 均可接入）
• 目标：构建可配置、可优化、可维护、可迁移

本文整理一条可落地的 Electron 学习路径：从进程模型与最小项目起步，逐层深入 IPC 安全、工程化、原生能力、性能与体积优化、打包分发。

• 适用场景：Web 开发者转型桌面端、内部工具、跨平台客户端
• 技术栈：TypeScript / 现代前端框架（Vue / React 均可接入）
• 目标：应用能跑、能稳、能小、能发、能维护

本文覆盖 TypeScript 的类型系统、语法、编译配置与工程实践，可作为学习与查漏的参考。

• 适用读者：会 JavaScript、想系统掌握类型系统的开发者
• 环境：Node.js 20+、TypeScript 5.x
• 阅读方式：前六节是基础，第七到第十节是类型进阶，第十一、十二节是工程配置

本文整理一套可落地的前端埋点（数据采集）方案：埋点类型与选型、事件模型与命名规范、SDK 设计（采集、队列、上报、降级）、自动埋点实现、隐私合规、数据治理与验收，最后给出方案对比与常见问题。

• 适用场景：Web / SPA / 微前端 / Electron 渲染层的数据采集
• 技术栈：TypeScript，框架无关（Vue / React 均可接入）
• 目标：埋点不丢、不重、可解释、可演进

本文按"组件 → 状态 → 副作用 → 性能 → 路由与状态管理 → 工程化"的顺序整理 React 的核心用法，示例基于 React 18/19 + 函数组件 + Hooks。

• 环境：React 18.2+ / 19、Vite 5+、Node 20+
• 示例默认 TypeScript 与 JSX
• 说明：React 19 的部分能力（use、Actions、ref 作为普通 prop）在文中单独标注

本文按"模板 → 响应式 → 组件 → 路由与状态 → 工程化与性能"的顺序整理 Vue 3 的核心用法，示例基于组合式 API 与 <script setup>。

• 环境：Vue 3.4+、Vite 5+、Node 20+
• 示例使用 Vue 3 + TypeScript 可选；纯 JS 同样适用
• 说明：Vue 3.5 起新增 useTemplateRef、props 解构保持响应性等能力，文中标注了版本

本文按"语法 → 对象与函数 → 异步 → 模块与浏览器 → 工程实践"的顺序整理 JavaScript 的核心知识，可作为系统学习与查漏的参考。

• 环境：Node.js 20+、现代浏览器（ES2020+）
• 示例可直接在浏览器控制台或 node 中运行
• 约定：文中"现代写法"指 ES2015 之后的语法

本文覆盖微前端的适用场景、核心概念，以及 qiankun、micro-app、无界（wujie）三个方案的基础使用、渲染机制、沙箱、路由与通信，最后给出横向对比与选型建议。

• 版本基线：qiankun 2.x、micro-app 1.x、无界 1.x（API 会随版本变化，落地前以官方文档为准）
• 示例栈：Vue 3 + Vite / React 18 + Vite，主应用为 history 路由
• 说明：三个方案都在快速演进，本文侧重"原理与用法共性"，具体选项以对应版本文档为准

本文覆盖 Docker 的核心概念、常用指令、Dockerfile 写法、数据与网络、Compose 编排，以及生产实践。每节都给出可直接执行的命令或配置。

• 环境：Docker 24+（本文命令在 Linux 与 Docker Desktop 上通用）

本文覆盖 NestJS 的架构模型（模块、控制器、提供者、依赖注入）、请求生命周期、参数校验、配置管理、数据库集成、测试与常见错误，可作为学习与查漏的参考。

• 环境：Node.js 20+、NestJS 11、TypeScript 5
• 前置知识：TypeScript 基础（装饰器、泛型、接口）、HTTP 与 REST

本文覆盖 PostgreSQL 的连接与工具、数据类型、表设计与约束、查询、索引与执行计划、事务与并发、权限、备份恢复与常用配置，可作为日常开发与运维的参考。

• 环境：PostgreSQL 16（大部分语法 13+ 通用）
• 客户端：psql、任意支持 PG 的 GUI（DBeaver、DataGrip）或 Node 驱动 pg

本文覆盖 Redis 的数据类型与命令、过期与淘汰、持久化、事务与 Lua、缓存模式、分布式锁、限流、消息队列、集群架构与运维排查。

• 环境：Redis 7.x、redis-cli
• 定位：内存数据结构服务，用于缓存、计数、协调与轻量消息

本文讲在 Node.js 里如何使用 Redis：客户端选型、连接与重连、常用数据结构操作、缓存与序列化、分布式锁、限流、管道与事务、Lua 脚本、发布订阅与 Stream，以及生产环境的连接管理与监控。

• 环境：Node.js 20+、Redis 7、ioredis 5.x、redis（node-redis）4.x/5.x
• 示例以 ioredis 为主，同时给出 node-redis 的对应写法

本文讲在 Node.js 里如何使用 PostgreSQL：驱动选型、连接池、参数化查询、事务、类型映射、错误处理与生产实践。示例基于 pg（node-postgres），同时给出 ORM 的选型建议。

• 环境：Node.js 20+、PostgreSQL 16、pg 8.x
• 示例默认使用 CommonJS，ESM 写法在文末说明

本文讲在 Node.js 里如何使用 MongoDB：驱动选型、连接与连接池、CRUD、游标、聚合、索引、事务、变更流、错误处理，以及 Mongoose 的使用方式。

• 环境：Node.js 20+、MongoDB 7、mongodb 6.x、mongoose 8.x
• 示例默认使用 CommonJS

本文覆盖 MongoDB 的文档模型、CRUD、查询与更新操作符、索引、聚合管道、事务、副本集与读写关注、Schema 设计与运维命令。 文档的特点：一个文档就是一个完整的对象，读取时一次取回，不需要 JOIN；代价是跨文档的关联与事务能力弱于关系库。

在使用 el-select 组件处理大量数据时，可能会遇到性能问题，如页面响应慢、滚动卡顿等。为了解决这些问题，可以通过引入虚拟列表技术对 el-select 进行优化。