开发工具
共 415 篇文章
git describe --always 仍输出标签，无法得到纯提交哈希
git describe 的 --always 只提供无合适名称时的哈希回退。有标签时改用 rev-parse 获取提交 ID；需要 dirty 标记时明确排除标签，并核对下游版本格式。
Python pathlib 拼接路径后父目录消失
pathlib 遇到后续绝对路径分量会舍弃前面的目录。区分 POSIX 绝对路径、Windows 根路径与相对路径，修正输入约定，避免用删除斜杠代替安全验证。
Android 构建报 Inconsistent JVM-target：对齐 Java、Kotlin 与 buildSrc
Java 与 Kotlin 编译目标不一致时，按任务路径定位 app、buildSrc 或构建约定，区分运行 JDK、工具链和产物目标，保留项目原有兼容要求。
LangGraph 加上 checkpointer 后，invoke 为什么要求 thread_id
LangGraph 本地图启用 checkpointer 后，需要在 configurable 中传 thread_id。核对会话复用、reducer、内存保存范围和跨请求配置传递。
React StrictMode 下，useEffect 为什么先 setup、cleanup，再 setup
StrictMode 开发检查会重跑 Effect。按每轮资源配对清理，区分重渲染、重复请求及服务端写入，不用 ref 跳过第二次 setup。
Git 解决冲突后按文件提交，报 cannot do a partial commit during a merge
Git 合并尚未完成时不能按路径做部分提交。先核对暂存区和未解决冲突，再用不带路径的 git commit 完成合并，避免把额外修改一并提交。
pandas merge 后行数变多：检查重复连接键与关系约束
pandas merge 后行数增多，按实际连接键检查多重匹配，用 validate 声明唯一性关系，结合 indicator 和缺失键规则核对结果，避免随意删除记录。
模型已搬到 GPU，PyTorch 仍报 CPU 和 CUDA 设备不一致
模型和输入已搬到 GPU，某些隐藏层仍留在 CPU。检查实际报错运算、子模块注册、to 的返回值及临时张量，避免优化器遗漏参数。
PromptTemplate 示例 JSON 被当成缺失变量
PromptTemplate 把 JSON 花括号当成占位符时，区分字面模板与变量值；核对双花括号、partial_variables 和重复模板化。
Android 14 前台服务启动崩溃：区分缺少类型、权限和后台启动限制
Android 14 前台服务崩溃时，按异常区分服务类型、对应权限、运行时前提和后台启动条件，以录音服务说明正确的顺序。
JavaScript 已给解构参数默认值，传 null 仍报 TypeError
解构参数的外层默认值只处理省略参数或 undefined。根据接口是否允许 null，选择修正调用方或在函数体内先归一化，再分别验证属性默认值。
Java 修改 subList 后原列表也变了，继续迭代时报并发修改异常
辨认 subList 区间视图与独立副本，按业务选择复制片段或通过活动 ListIterator 修改，保留浅拷贝和失效视图边界。
VS Code 无法运行 Activate.ps1：先区分 PowerShell 策略与 Python 环境
VS Code 的 Activate.ps1 被 PowerShell 策略阻止，直接检查环境解释器，按终端与组策略选择激活方式，临时设置可恢复。
ts-node ESM 找不到相对模块：导入应写输出文件的 .js 扩展名
ts-node 已加载 ESM 入口却找不到相对模块时，核对显式扩展名、Node 模块解析与源文件映射；开发运行和编译产物分别验证。
Python 直接执行包内文件，相对导入报 no known parent package
用完整模块名启动包内入口，区分没有父包与超出顶层包；核对工作目录和解释器，保留兄弟子包的正确导入关系。
Python 在 finally 中 return，未处理的异常没有传给调用方
Python finally 中的 return 会丢弃待传播异常并覆盖原返回值。把返回放回成功路径，清理留在 finally，明确默认值对应的异常，并核对 CPython 3.14 的编译警告边界。
Python 读取 JSONL 报 Unexpected UTF-8 BOM
JSONL 第一行报 Unexpected UTF-8 BOM，给文本行加 decode 又报属性错误。确认文件头后用 utf-8-sig 打开，区分逐行 JSON 与整份文档，并保留字符和记录数量。
Spring Boot 自定义 Hikari 数据源报 jdbcUrl is required
自定义 Hikari 数据源已有 URL 却报 jdbcUrl is required，沿 Bean 确认绑定对象。区分直接绑定 jdbc-url 与 DataSourceProperties 的 url 转换，保持两层参数前缀一致。
Go 重装后仍报 toolchain not available：检查持久化 GOTOOLCHAIN
Go 重装后仍请求不存在的 go1.22 工具链，可检查用户 GOENV 中持久化的 GOTOOLCHAIN。只撤回错误设置，保留模块要求、其他配置与下载校验。