赵士杰——成功并非一蹴而就，而是在持之以恒的努力中逐渐实现。

原创 一文读懂 JWT 无状态身份认证的核心原理

JWT 是目前前后端分离、微服务架构中最常用的无状态身份认证方案。本文用简洁易懂的方式，带你快速掌握 JWT 的签发、传递与校验核心逻辑，轻松理解其工作原理与安全机制。

原创 后端必看！FastAPI 接口鉴权详解：OAuth2 密码流 + JWT 签发与验证

本教程将详细讲解 FastAPI 中 OAuth2 + JWT 认证的实现流程，从核心原理、基础实现，到进阶优化（如刷新令牌、权限控制、安全加固），全程提供可直接复制运行的代码，兼顾入门友好性与生产环境实用性。

原创 MacOS 本地部署 OpenClaw 并接入阿里云百炼大模型（超详细实操指南）

本文详细讲解了 MacOS 环境下 OpenClaw 从依赖安装、Node 环境配置、阿里云百炼 API Key 获取，到 OpenClaw 安装、初始化、功能验证及完整卸载的全流程。通过 QuickStart 模式可快速完成本地部署，满足个人用户对接阿里云百炼大模型的基础需求；如需自定义配置，可通过 openclaw configure 调整模型、渠道等参数。

原创 FastAPI API Key 认证

在实际开发中，接口认证是后端服务的第一道安全防线身份校验：确认调用接口的用户 / 服务是合法的，拒绝非法访问；权限控制：防止未授权用户操作敏感数据（如用户信息、订单、管理后台接口）；日志追溯：通过认证信息定位接口调用者，便于问题排查；合规要求：满足数据安全规范（如隐私数据保护、企业安全标准）。如果没有认证，你的接口会直接暴露在公网，任何人都能随意调用，极易导致数据泄露、恶意攻击、服务滥用等严重问题。

原创 MacOS 国内镜像一键安装 Homebrew

本文专为长期使用 Windows、刚切换到 Mac 阵营的开发者编写，清晰讲解 Homebrew 所有主流安装方式，覆盖新手入门、进阶操作，同时解决国内安装慢、依赖缺失等常见问题，本教程适配所有 Apple Silicon 芯片（M1/M2/M3/M4/M5 等）设备。

原创 FastAPI 集成 Redis 开发手册

本文提供可落地的 FastAPI + Redis 异步集成方案，从环境搭建、配置管理、客户端封装，到接口开发、生命周期管理，全程采用异步编程规范，兼顾代码可维护性与性能，同时补充实操细节和避坑点，带你快速完成集成落地。

原创 OpenClaw 接入 Tavily API 开启 Web Search 联网搜索功能

本文档详细说明如何通过 openclaw configure 命令配置 **Tavily API**，为 OpenClaw 启用 **Web Search 联网搜索** 能力，实现 AI 智能体实时获取网络信息、事实核查、内容检索等功能。

原创 超详细！PicGo+GitCode+Typora 图床搭建全攻略（新手友好版）

本教程采用「PicGo（图片上传工具）+ GitCode（国内免费代码托管平台）+ Typora（Markdown 编辑器）」组合，兼顾稳定性、访问速度与易用性，全程免费且无需复杂命令，新手可直接跟着步骤操作。搭建完成后，即可实现 Markdown 写作“粘贴图片即上传”，跨设备、跨平台访问文档时，图片均能正常显示，彻底解决图片存储与同步难题。

原创 Swagger UI 本地化部署，解决 FastAPI Swagger UI 依赖外部 CDN 加载失败问题

FastAPI 默认集成的 Swagger UI 依赖 `cdn.jsdelivr.net` 外部 CDN 加载核心静态资源，但在实际开发中，常因外部 CDN 访问不稳定、企业内网 / 隔离环境无法访问外网等场景，导致 Swagger UI 出现加载失败、访问超时甚至页面空白等问题。为保障接口文档的访问速度与稳定性，彻底摆脱外部资源依赖，可将 Swagger UI **静态资源手动下载**并本地化部署，既保留原 `/docs` 接口文档的访问路径，又能实现无外部网络依赖的稳定访问。

原创 MacOS 使用 pyenv + brew 优雅管理 Python 多版本环境

本文采用「**pyenv + Homebrew**」方案，为 MacOS 搭建干净、隔离的 Python 多版本环境，彻底避免污染系统自带 Python，完美适配不同项目版本需求。

原创 【已解决】SqlAlchemy 插入 MySQL JSON 字段时 None 变为 ‘null‘ 字符串，WHERE IS NULL 失效

在使用 SqlAlchemy 操作 MySQL 数据库的过程中，你可能会遇到一个非常隐蔽的问题：当向 JSON 类型的字段插入None值时，数据库中最终存储的不是 MySQL 原生的NULL，而是字符串'NULL'。这个问题会导致后续查询（比如WHERE json_col IS NULL）完全失效，给数据处理带来诸多麻烦。本文将详细分析问题原因，并给出简洁有效的解决方案。

原创 今日公测｜腾讯 QClaw 安装教程｜像素工作室，给你的龙虾一个家

今日，腾讯官方宣布旗下 AI 办公智能体 QClaw 正式开启全量公测，无需申请邀请码，所有用户均可通过官网免费下载。QClaw 是腾讯电脑管家基于 OpenClaw 开源生态打造的**本地化 AI Agent 助手**，核心优势如下：- 零门槛部署：无需 Node.js、Python 基础，无需命令行 / 编程操作，开箱即用；- 智能模型调度：内置模型自动适配任务需求，无需手动配置；- 跨平台远控：支持五大主流 IM 工具，手机端发指令即可让电脑自动执行并反馈；- 特色功能丰富：新增企微智能

原创 代码重构怕踩坑？基于 ASM+Maven 插件实现分析 Java 方法调用链（附完整代码）

本文将详细讲解如何基于 ASM 框架开发一款 Maven 插件（AnalyzeCallChainMojo），实现对 Java 编译后的.class 文件进行方法调用链分析。该插件能够指定目标类，自动扫描类文件目录、解析方法调用关系，并以树形结构输出调用链（含循环调用检测），适用于代码调用关系梳理、接口链路分析等场景。

原创 Gradle 的项目结构与源码集（Source Sets）详解（Kotlin DSL）

本文介绍了Gradle项目中源码集(Source Sets)的概念与应用。源码集是Gradle对项目源码分组的抽象描述，通过目录结构区分生产代码和测试代码，并自动关联相关构建任务。

原创 Gradle 多模块依赖集中管理方案，Version Catalogs 详解（Kotlin DSL）

告别依赖版本不一致！Gradle Version Catalogs（Kotlin DSL）多模块实战指南

原创 告别重复编码！SpringBoot 字段变更（新旧值）日志工具类的规范化设计与优雅实现

基于 SpringBoot 工具化实现的的字段对比 + 变更日志记录方案，通过链式调用封装了所有重复逻辑：自动完成字段对比、日志对象构建、批量存储等操作；基于函数式接口驱动的设计，支持开发者按需自定义核心逻辑 —— 无需修改工具源码，即可适配不同业务场景（如金融场景的高精度对比、日志分级存储需求等）

原创 深入了解 Vue 3 组件间通信机制

深入了解 Vue 3 组件间通信机制

原创 Java 字节码工具 ASM，实现类的动态增强

ASM是一个轻量级、高性能的Java字节码操控框架，能够直接读取、修改和生成.class文件。广泛应用于Spring、MyBatis等框架中实现AOP、动态代理等功能。支持类增强、代码混淆、热部署等场景

原创 从零开始学习 TOML，配置文件的新选择

TOML 的语法设计遵循 “直观、一致、无歧义” 的原则，所有规则都围绕 “让人类易读、机器易解析” 展开，在编写 TOML 文件时，需要遵守以下基本的语法规范。

原创 Gradle Task高级特性指南：自定义任务、增量构建与状态流转

深入讲解自定义任务、增量构建、状态流转、条件执行等高级特性，适合有一定基础后，提升构建效率和处理复杂场景。

原创 深入理解 buildSrc：Gradle 共享构建逻辑的一把利刃

介绍了 Gradle 中buildSrc作为特殊目录的作用，自动构建与集成的原理，以及在多模块项目中统一管理依赖、插件和任务的价值。内容涵盖buildSrc的创建步骤、标准目录结构，以及通过 Kotlin 编写共享任务、集中管理依赖版本的具体实现。通过buildSrc可实现构建逻辑的复用与统一维护，解决多模块项目中的版本冲突和重复配置问题，提升项目可维护性。

原创 Gradle Task入门指南：核心概念、执行逻辑与基础配置

覆盖 Gradle Task 的核心概念、定义、执行、基础配置和常用内置类型，帮助新手快速上手，能独立完成简单构建任务。

原创 （二）Gradle 依赖仓库及安全凭证配置

本文介绍 Gradle 依赖仓库及安全凭证配置，涵盖 Maven、Ivy、本地目录等仓库类型及配置，说明仓库优先级规则，详解私有仓库认证方式、敏感信息安全存储方案，强调强制使用 HTTPS 的重要性。

原创 Gradle 入门第一步，基础环境搭建（Windows）

Gradle 零基础入门内容，含 Windows 下 JDK 检查、Gradle 下载配置与缓存优化，还教用 IDEA 创建 Gradle Java 项目、配置环境并运行程序，帮新手快速上手。

原创 （五）Gradle 依赖传递与冲突处理

本篇文章将深入探讨Gradle的依赖传递机制及冲突处理方法。我们将介绍如何利用Gradle的依赖排除、版本管理及依赖树分析工具，解决项目中的版本冲突和依赖管理问题。

原创 （四）Gradle 依赖树分析与依赖关系优化

本文聚焦 Gradle 依赖树分析与优化，详解依赖树包含的 GAV 坐标、依赖关系等核心信息，解读依赖树符号含义，演示dependencies全局分析、dependencyInsight特定追踪等命令用法，及结合系统命令快速过滤依赖的技巧。

原创 （三）Gradle 依赖版本控制

本文系统介绍了 Gradle 中三种核心的依赖版本管理方式，以及 Rich Versions 进阶用法

原创 （一）Gradle 依赖声明与配置类型

介绍 Gradle 依赖声明格式与坐标，详解 implementation、api 等配置的生效阶段、传递性及适用场景。

原创 【无标题】

原创 【并发编程】详解 ReentrantLock：深入剖析 AQS 支撑下的可重入锁机制与实现原理

【并发编程】详解 ReentrantLock：深入剖析 AQS 支撑下的可重入锁机制与实现原理

原创 分享一次通过软考高级系统架构师的备考经验

你好，未来的架构师！以下是我个人一次通过软考系统架构师的经验总结，希望对你能有所帮助。

原创 多 Git 账号管理解决方案，SSH 密钥配置实战技巧（附详细图文教程）

本文以 GitHub + GitCode 场景演示：通过不同 SSH 密钥区分两个账号，实现免密推送远程 Git 仓库。

原创 Vue3 组件注册的四种方式，究竟谁更胜一筹？

在 Vue3 的项目开发中，组件化是一个核心特性，它可以让我们将页面拆分成多个小的、可复用的组件，从而提高代码的可维护性和可复用性。而在使用 Vue 组件之前，我们需要先对其进行 “注册”，这样 Vue 才能在渲染模板时找到其对应的实现。本文将详细介绍 Vue3 中四种常见的组件注册方式，希望能帮助你更好地掌握 Vue3 的组件注册技巧。

原创 Kotlin 基础语法

Kotlin 是一种现代的、静态类型的编程语言，由 JetBrains 开发。它运行在 Java 虚拟机 (JVM) 上，并且可以与 Java 代码无缝互操作。Kotlin 设计的目标之一是简化开发流程，提升开发者的生产力。它不仅支持面向对象编程，还支持函数式编程，使得代码更加简洁和表达力更强。

原创 【已解决】ElementPlusError: [ElForm] unexpected width 0

使用 Vue3 + ElementPlus 开发前端项目时，切换登录表单组件时控制台报错 `ElementPlusError: [ElForm] unexpected width 0`，

原创 Springboot 使用【过滤器】实现在请求到达 Controller 之前修改请求体参数和在结果返回之前修改响应体

Springboot 使用【过滤器】实现在请求到达 Controller 之前修改请求体参数和在结果返回之前修改响应体

原创 解读 Java 经典巨著《Effective Java》90条编程法则，第2条：遇到多个构造器参数时要考虑使用构建器

《Effective Java》是由 Joshua Bloch 撰写的经典书籍，提供了 Java 编程中的最佳实践和建议。在书中的第2条建议“遇到多个构造器参数时要考虑使用构建器”，主要是为了处理构造器参数过多时的设计问题。这条建议的主要目的是简化构造器的使用，增加代码的可读性和维护性。

原创 认识和使用 Vite 环境变量配置，优化定制化开发体验

Vite 是一个现代化的前端构建工具，支持快速的开发和构建过程。在 Vite 中，环境变量起着至关重要的作用，可以根据不同的环境加载不同的配置，方便开发和部署。在你提供的内容中，详细介绍了 Vite 中环境变量的相关内容，包括内置的环境变量、.env 文件的加载规则、业务代码中获取变量的方法、在 HTML 文件中获取变量的方式、在 vite.config.ts 中获取变量的方法等。此外，还介绍了如何自定义变量的前缀以及指定加载 .env 文件目录的方式。

原创 Layout 布局组件快速搭建

Layout 布局组件快速搭建：1. 设置主题样式变量2. 封装公共布局组件3. 经典布局4. 水平布局5. 响应式布局6. 搭建 Layout 布局组件7. 添加 Layout 路由配置8. 启动项目

原创 一站式学习 Shell 脚本语法与编程技巧，踏出自动化的第一步

详细解析 Shell 脚本编程的语法结构和基本命令，帮助你快速上手自动化操作，简化日常工作流程。