这里是我整理的一些专栏博客，方便各位友人查阅。
1. 大模型实战
由浅入深快速进行大模型相关开发的实战，尽可能少一点理论，多一点实操。
示例代码可以在 GitHub 仓库 中找到。
2. Flutter 测试实战
本专栏共收录 5 篇工程实战与避坑笔记。
| 章节与文章 | 核心摘要 / 解决痛点 | 核心技术标签 |
|---|---|---|
| 1. Flutter E2E 测试从 integration_test 迁移到 Patrol | 为 Flutter 应用落地端到端自动化测试，记录从官方 integration_test 迁移至 Patrol 框架的实战全流程。涵盖 Android 与 iOS 原生权限弹窗模拟点击、分层模块化用例重构，以及排查 Isar 本地数据库并发冲突与 Mock | Flutter Patrol E2E测试 Android |
| 2. Patrol iOS 集成测试 xcodebuild exit code 70 全链路排查 | 记录在 Flutter 项目中将 Patrol E2E 测试从 Android 扩展到 iOS 模拟器时遇到的一系列问题：xcodebuild exit code 70、RunnerTests vs RunnerUITests 目标配置、模拟器克隆、press | Flutter Patrol iOS Xcode |
| 3. IsarCore 动态库冲突与 Widget 测试 HTTP 拦截解决 | 记录 Flutter 项目在使用 Isar NoSQL 本地数据库进行自动化并发集成测试时遭遇的偶发性崩溃排查。重点分析测试多 isolate 并发调度引发的 IsarCore 底层动态库句柄竞争，定位 Widget 测试中 Mock HTTP 拦截器因时序异 | Flutter Isar 单元测试 并发测试 |
| 4. GoRouter 结合 Isar 运行测试并发与粘性线程死锁排查 | 记录在 Flutter 项目中，使用 GoRouter 配合 Isar 数据库进行 Widget 测试时，由于 runAsync 导致异步事件逃逸，以及 tearDown 提前关闭数据库所引发的 MDBX 粘性线程断言崩溃和 CI 卡死问题。通过共享测试套件 | Flutter GoRouter Isar 死锁排查 |
| 5. Android inexactAllowWhileIdle 调度策略与本地通知测试 | 记录在 Flutter 项目中实现过期提醒通知功能时，遇到的 Android 系统调度延迟、精确闹钟权限困境、测试验证难题等问题，以及如何通过 inexactAllowWhileIdle + 应用内计时器的混合方案，在保证用户体验的同时实现省电优化和快速测试验 | Flutter Android AlarmManager 本地通知 |
3. Git 避坑与工作流
本专栏共收录 4 篇工程实战与避坑笔记。
| 章节与文章 | 核心摘要 / 解决痛点 | 核心技术标签 |
|---|---|---|
| 1. Windows 下 Git open(xxxx) Filename too long 报错根治 | 在 Windows 环境开发多层级项目时，常因路径超出 260 字符上限触发 Git 的 Filename too long 报错。本文剖析 Win32 API 历史限制与 Git 寻址机制，提供配置 core.longpaths 与修改注册表 LongPat | Git Windows 路径超限 core.longpaths |
| 2. Git refusing to work credential missing host 报错排查 - Git 避坑指南 02 | 在混合使用企业内网代码仓库与 GitHub 公网进行开发时，常因多套 SSH 密钥冲突、Git 凭据管理器（GCM）配置错位或旧版 insteadOf URL 强制重写规则，触发 missing host field 报错。本文详细记录从全局配置审计到凭据彻底 | Git Windows 凭据管理 鉴权失败 |
| 3. Git inexact rename detection was skipped 根因与优化 - Git 避坑指南 03 | 在项目重构、Git Rebase 或分支 Merge 时，常因文件变动量超出默认阈值触发 inexact rename detection was skipped 告警。本文记录该警告背后的启发式重命名检测算法原理，并提供调整 merge.renameLimi | Git Rebase 性能优化 重命名检测 |
| 4. 把 VS Code 打造成 Git 终极编辑器、Diff 与 Merge 利器 | 每次执行 git commit 都弹出 nano 让人手忙脚乱？遇到代码冲突只能手动在文本中搜寻并删除冲突标记？本文详细介绍如何通过全局配置 core.editor 与 merge.tool，将 Git 默认编辑器与图形化三方冲突解决器完全交由 VS Code | Git VS Code Diff 3-Way Merge |
4. 独立博客 SEO 与 GEO
本专栏共收录 3 篇工程实战与避坑笔记。
| 章节与文章 | 核心摘要 / 解决痛点 | 核心技术标签 |
|---|---|---|
| 1. 从拦截 AI 爬虫到成为大模型答案源 | 深度剖析独立博客在 AI 时代的流量密码。从打破 2023 年陈旧的 robots.txt 封锁，到注入 Schema.org JSON-LD 知识图谱实体，再到打造契合 RAG 分块检索的高增益内容架构，全面实现 SEO 与 GEO（生成式引擎优化）的双重跃 | SEO GEO 生成式引擎优化 JSON-LD |
| 2. IndexNow 毫秒级主动推送与全站语义拓扑网格 | 介绍通过 IndexNow 协议打破传统 Sitemap 轮询延迟，实现博文发布向 Bing/Yandex 主动推送的方案。结合 Cloudflare Pages CI/CD 搭建增量自动流水线，并在构建期生成 /llms.txt 结构化文本与全站语义内链拓扑 | SEO GEO IndexNow 自动化部署 |
| 3. 国内搜索引擎收录实战：百度与头条搜索接入、无备案验证绕行与自动化推送 | 详细复盘未备案独立博客接入国内主流搜索引擎（百度与头条/抖音/豆包）的完整工程实践。解决 Cloudflare 308 重定向导致的根目录验证失败与百度 Sitemap 0 配额问题；剖析 360 与搜狗的备案硬性拦截；打通百度单日 10 条 API 配额分片 | SEO GEO 百度站长 头条搜索 |
5. Python 类型体操
本专栏共收录 4 篇工程实战与避坑笔记。
| 章节与文章 | 核心摘要 / 解决痛点 | 核心技术标签 |
|---|---|---|
| 1. 使用 Self 终结继承时的类型推断灾难 | 在 Python 面向对象编程中，方法返回当前类实例时常遇继承类型退化问题。本文介绍 typing_extensions 库中的 Self 类型，讲解如何在链式调用 (Builder 模式)、类工厂方法及上下文管理器中优雅解决此问题，提升代码类型安全与 IDE | Python typing_extensions Self 类型推断 |
| 2. 使用 @override 打造重构代码时的“防呆神器” | 在大型面向对象 Python 项目中，子类重写父类方法时极易因拼写疏忽、参数不一致或父类方法重构而引入隐蔽的运行时 Bug。本文系统介绍 typing_extensions 中的 @override 装饰器规范，讲解其如何与 mypy 及 IDE 静态分析协同 | Python typing_extensions override 代码重构 |
| 3. 使用 Unpack 结合 TypedDict 给 **kwargs 装上透视眼 | Python 的 **kwargs 极大地提升了函数的灵活性，但也让代码失去了 IDE 的类型补全，成为了可怕的类型黑洞。本文详细讲解如何利用 typing_extensions 中的 Unpack 和 TypedDict，在保留原生关键字传参优雅性的同时，让 | Python typing_extensions Unpack TypedDict |
| 4. 使用 TypeIs 替代危险的 cast 做最严谨的类型收窄 | 处理外部传入的 JSON 或 Any 类型数据时，如何安全地告诉 IDE 变量的具体类型？本文深入解析 typing_extensions 中的 TypeIs（原 TypeGuard 的究极进化版），教你告别危险的 cast()，实现带静态推断的安全类型校验。 | Python typing_extensions TypeIs TypeGuard |
6. VS Code 效率与避坑指南
本专栏共收录 6 篇工程实战与避坑笔记。
| 章节与文章 | 核心摘要 / 解决痛点 | 核心技术标签 |
|---|---|---|
| 1. VS Code Remote Tunnels 本地调试 Kaggle GPU 环境 - VS Code 指南 02 | 详细记录如何利用 VS Code 官方 Remote Tunnels（远程隧道）技术，将 Kaggle 云端免费双 T4 GPU 算力无缝接入本地 VS Code 客户端。摆脱网页端 Notebook 补全迟钝与断点调试困难的限制，无需第三方内网穿透工具即可实 | VS Code Remote Tunnels Kaggle 远程调试 |
| 2. VS Code 单步调试 Python 第三方库源码配置 | 在 Python 开发中，常规调试模式默认会跳过第三方库源码导致底层 Bug 难以定位。本文记录如何通过在 VS Code 的 launch.json 中关闭 justMyCode 参数，解除调试器黑盒限制，直接单步潜入 site-packages 依赖库与标 | VS Code Python 源码调试 Debug |
| 3. VS Code Remote-SSH 密钥免密登录配置 | 详细记录在 VS Code Remote-SSH 远程开发环境下配置基于非对称加密密钥对实现安全免密登录的工程全流程。深度梳理本地客户端公私钥生成、服务器 authorized_keys 写入、Linux 文件权限 600 与 700 严格校验规范，以及多主机 | VS Code SSH 免密登录 秘钥配置 |
| 4. 基于 VS Code 远程开发的 GPU Docker 容器自动清理方案 | 记录在 Ubuntu 22.04 共享 GPU 服务器环境中，解决开发者笔记本合盖断网导致显存被 Docker 容器长期占死的工程实践。通过编写独立后台守护进程轮询 sshd 活跃会话数，并在全断开超时后自动停止容器，攻克了 Rootless Docker 环 | Docker Linux Shell GPU释放 |
| 5. VS Code 连接 WSL 每 10 分钟闲置掉线排查 | 记录日常开发中 VS Code 连接 WSL2 频繁断连且无系统报错的完整排查历程。从怀疑内存 OOM、文件监听数超限，到代理冲突，最终通过 Extension Host 日志揪出企业安全软件 (Zscaler) 600 秒闲置强杀机制，并利用 Mirrore | VS Code WSL2 Zscaler TCP Keep-Alive |
| 6. VS Code 终端日志截断与会话持久化配置 | 在 VS Code 中调试大型构建与深度学习训练任务时，海量日志常因超出默认缓冲区上限而被截断丢失。本文深入解析集成终端 terminal.integrated.scrollback 与会话持久化缓冲区之间的底层机制差异，提供科学设置日志行数上限、规避内存泄漏 | VS Code 终端配置 日志排查 缓冲区 |
7. Hexo 博客建站与优化实战
本专栏共收录 5 篇工程实战与避坑笔记。
| 章节与文章 | 核心摘要 / 解决痛点 | 核心技术标签 |
|---|---|---|
| 1. 基于 Cloudflare Pages 与 CI/CD 自动化构建部署实战 | 记录如何将基于 React、Vite 与 OpenCV.js (WebAssembly) 构建的前端计算密集型应用，以零服务器成本自动化部署至 Cloudflare Pages 全球 CDN。深度复盘 GitHub Actions 持续集成流水线、Node 构 | Cloudflare Pages React Vite WebAssembly |
| 2. Hexo new 日期无法自动生成且出现 object Object 报错解决 | 在执行 hexo new 新建博文时，发布时间参数 date 无法自动填充当前时间戳，甚至退化为异常对象语法。本文深入剖析 Hexo 脚手架底层基于 Nunjucks 模板的变量插值渲染机理与 YAML 严格缩进解析陷阱，给出模板安全写法规范，确保博文时间戳在 | Hexo 静态博客 脚手架 模板引擎 |
| 3. Hexo NexT 本地化集成 Fancybox 5 高清灯箱 | 技术长文中的架构拓扑图常因正文排版宽度限制而模糊不清。本文记录在 Hexo NexT 8.x 中深度集成 Fancybox 5 高清灯箱的工程全流程。攻克国内外部 CDN 不稳定、Gemini 双栏布局侧边栏 z-index 层级穿透、图片懒加载空白以及资源本 | Hexo NexT Fancybox 前端交互 |
| 4. Hexo NexT 静态资源本地自托管、KaTeX 公式渲染与移动端适配 | 深入记录 Hexo NexT 主题静态资源本地化与数学公式排版调优的实战全流程。针对 KaTeX 公式渲染中字体文件路径解析 404 缺失、复杂矩阵跨行排版错位以及移动端视口横向溢出破损布局等典型前端样式异常，提供包含 Styus 样式覆盖与本地 CDN 托管 | Hexo NexT KaTeX 前端工程 |
| 5. 技术博客工程化治理与 WebP 自动化质量门禁 | 针对拥有 50+ 篇技术长文的 Hexo 博客开展系统级工程化治理实战。涵盖全站零 Emoji 规范清洗、自动化脚本批量转换 WebP 静态资产瘦身 67%、基于 uv 虚拟环境构建本地质量审计工具与 Git Pre-commit 门禁，以及放行大模型爬虫并构 | Hexo 性能优化 WebP Core Web Vitals |
8. 开发环境与网络避坑
本专栏共收录 4 篇工程实战与避坑笔记。
| 章节与文章 | 核心摘要 / 解决痛点 | 核心技术标签 |
|---|---|---|
| 1. critical libmamba Shell not initialized 报错排查 | 使用 micromamba 激活虚拟环境时，常遇 subprocess and cannot modify the parent shell 报错。本文剖析系统安全机制限制子进程修改父终端环境变量的机理，提供执行 micromamba shell init 写 | micromamba Shell 子进程 环境配置 |
| 2. micromamba 报错 Shard Index not available 与检索卡顿排查 | 在使用 micromamba 检索内部私有 Artifactory 镜像源与包仓库时，常遭遇 search 响应极度缓慢甚至长时间挂起的异常。本文深入分析该现象背后由 micromamba 2.6.x 底层并发网络请求引起的性能回退 Bug，并提供版本锁定降级 | micromamba Conda 性能调优 Artifactory |
| 3. npm ERR! code EHOSTUNREACH 与 IPv6 网络阻断排查 | 记录在执行 npm install 时遭遇 connect EHOSTUNREACH 报错的排查过程。深入解析 Node.js 底层 IPv6 优先级导致的网络阻断问题，并提供从环境变量配置、国内镜像切换到 Linux 系统级 DNS 优先级的完整工程解决方案 | npm Node.js IPv6 网络排查 |
| 4. Android 模拟器代理联网与 No Internet WiFi 锁死排查 | 记录 Android 原生模拟器配置网络代理时，因国内网络无法访问 Google Captive Portal 探测服务器导致已连接但无法访问互联网的故障排查。分析宿主机 VPN 与系统全局代理的双重回路冲突，给出利用 ADB 修改网络质量探测源、放行内网网段 | Android 模拟器 代理配置 Clash |