麻雀窝 Sparrow Zoo

DOCUMENTATION / 开发文档

开发文档

从工程架构、接口集成到问题排查,查阅项目中的实现说明与实践记录。

移动端

从 Expo 57 脚手架到双端模拟器:一次完整的安装与验证记录

记录 Expo 57 移动端脚手架的版本选择、依赖安装、Android 与 iOS 工具链、原生构建、模拟器故障排查和实际交互验证,并解释每一层验证能证明什么。

准备在 macOS 上搭建 Expo 57、构建 iOS 与 Android 开发版的开发者;环境记录为 2026-10-21。
Expo 57React NativeExpo RouterNativeWindAndroid 模拟器iOS Simulator原生构建Metro
前端开发
前端架构

跨域 SSO 下的用户信息共享与解耦:Context、职责边界与 token 重签

结合一次登录用户重构,说明跨域 SSO 中 token 即用户信息唯一载体,父子组件通过 Context 共享 LoginUser,HTTP 与 WebSocket 各司其职,修改头像后端重签 token 以守护数据一致。

前端与全栈工程师(涉及跨域登录、React Context、WebSocket 集成)
跨域 SSOReact ContextJWTtoken 一致性WebSocketFetcheruseLoginUser头像重签职责解耦LoginUserProvider
前端开发
JavaScript

0 == "" == true:JavaScript 宽松相等的类型强制陷阱

0 == "" == true 为什么等于 true?本文从宽松相等(==)与严格相等(===)的区别出发,拆解 JavaScript 隐式类型转换的完整规则,覆盖 falsy 值、字符串转数字、数组 ToPrimitive、null/undefined/NaN 特例与链式比较的左结合陷阱,附常见结果速查表与工程最佳实践。

前端 / 全栈开发者(了解基础 JS 语法)
JavaScript类型强制宽松相等严格相等=====falsyToPrimitive抽象相等
前端开发
Web Storage

Web Storage 的边界与跨域 SSO:从 Safari 差异到客户端 RPC

结合手机 localStorage 返回 null 的反馈,解释同源、同站与存储分区,重点说明 Cookie 承载登录凭据如何消除 iframe 存储依赖,以及 HttpOnly、凭据请求和跨站限制。

前端与集成开发者(涉及跨域登录、iframe 集成)
Web StoragesessionStoragelocalStorage存储分区postMessage客户端 RPC跨域 SSOCookieHttpOnly
前端开发
React

useCaptcha 验证码 Hook 源码解析

拆解前端验证码自定义 Hook 的「两阶段加载」设计、会话与图片的先后时序,以及缓存击穿、事件监听累积等值得注意的隐患。

前端开发者(React 18)
React验证码useCaptcha自定义 Hook两阶段加载useEffectuseRef
前端开发
React

把 React 组件嵌入非 React 页面:HtmlFragment 与客服挂件

用 createRoot 与 useEffect 把客服组件接进官网、商城等非 React 架构:讲清 HTML 片段如何生成、注入,以及为什么静态导出会多出文档外壳。

前端与集成开发者(React 18 / Next.js App Router)
ReactcreateRootuseEffectHtmlFragment客服挂件Next.js静态导出
前端开发
Next.js

Next.js 15 四站静态上线

本机用 build-static.sh 打包单个 tar.gz,上传服务器后执行 deploy.sh 切换版本,浏览器验收;出问题用 rollback 恢复上一版。

前端 / 运维工程师(Next.js 15 静态导出 · next-intl 4.x)
Next.js 15静态导出Nginx静态部署回滚
前端开发
Next.js

next-intl 国际化权威指南及使用说明

讲清 Next.js App Router 下 next-intl 的「URL 前缀 + 中间件 + Context」三位一体方案:标准配置五步、多消息分组落地,以及语言切换失效的排查表。

前端开发者(Next.js 15 App Router + next-intl v4)
next-intlNext.jsApp Router国际化i18nmiddlewareuseTranslations
前端开发