开发工具
共 415 篇文章
Room 报迁移路径缺失：已写 Migration 仍失败，先检查实际 Builder
Room 提示迁移路径缺失，检查真正使用的数据库 Builder、版本路径和 schema 一致性，通过迁移测试保留旧记录，避免以删库或破坏性回退掩盖升级问题。
训练越跑越占显存，running_loss += loss 会留下什么
区分日志累加、待反传损失与 retain_graph；用数值保存训练日志，并按相同步骤观察已分配显存，避免把缓存或优化器状态误判为泄漏。
npm 全局安装 EACCES：检查 prefix、权限与 PATH
遇到 /usr/local/lib/node_modules 权限错误，先确认 node/npm、prefix 与失败目录，再采用版本管理器或用户目录并核对 PATH。
curl 发送文件后换行丢失，Content-Length 小于文件大小
curl 使用 --data @文件 时会去掉回车、换行和空字节。保留请求体原始内容应使用 --data-binary，并核对媒体类型、原始字节及接口处理结果。
Python 比较时间报 can't compare offset-naive and offset-aware datetimes
带偏移的时间与 datetime.now() 比较时报 TypeError，使用 aware UTC 当前时间，区分 astimezone 转换和 replace 标记，避免无声改变时间含义。
Jupyter 调用 asyncio.run 报 running event loop：在单元格中等待协程
Jupyter 单元格已有事件循环时，使用顶层 await 等待异步函数。区分普通脚本入口、autoawait 配置和库内部同步入口，保留异常与结果传递。
Android 12 创建 PendingIntent 崩溃：正确选择 FLAG_IMMUTABLE 与 FLAG_MUTABLE
普通通知、直接回复和依赖库分别检查 PendingIntent 创建点，按功能选择不可变或可变标记，并处理 targetSdk 34 的目的地限制。
Maven 报 release version 21 not supported：实际 JDK 与项目要求不符
Maven 版本检查通过后仍不支持 release 21，应核对当前 POM 与实际编译 JDK，区分 Maven 运行环境、toolchain 和 CI 镜像。
git checkout -- * 因未跟踪文件报 pathspec 错误
git checkout -- * 报未跟踪文件的 pathspec 错误时，先核对 shell 展开和索引状态，再用明确路径恢复。说明暂存区与 HEAD 的区别及覆盖前的备份要求。
FAISS 的 IndexFlatIP 为什么会返回大于 1 的分数
IndexFlatIP 返回内积。需要余弦相似度时，库向量与查询向量都要归一化，检查 float32、零向量及原地修改行为，区分 L2 与近似索引。
Python 列表调用 sort 后，接收结果的变量变成 None
Python list.sort 原地修改列表并返回 None，空列表也不例外。按是否需要修改输入选择单独调用 sort 或返回 sorted 新列表，核对别名、空输入与恢复原顺序的边界。
safetensors 报 HeaderTooLarge，下载到的可能只是 LFS 指针
HeaderTooLarge 不等于权重模型太大。检查实际文件前缀、大小与哈希，识别 Git LFS 指针和错误页，再按原格式补全文件。
Git 克隆后目录为空，提示 remote HEAD refers to nonexistent ref
Git 对象已下载却没有检出文件时，核对远端 HEAD 与实际分支。恢复本地跟踪分支，并区分指定分支克隆、本地 origin/HEAD 和服务端默认分支修复。
Starlette TestClient 升级 HTTPX 后报 unexpected keyword argument app
HTTPX 0.28 删除 app 参数后，旧 Starlette TestClient 可能在构造阶段失败。核对实际测试环境、框架约束与锁文件，再验证 lifespan 和原测试。
Windows 的 DataLoader 一加 num_workers 就报 bootstrapping phase
num_workers=0 正常、开启多进程后失败时，检查 spawn 导入入口、main 保护及顶层 Dataset 定义；不要只压掉 worker 异常。
Java 把 int[] 传给 Arrays.asList 后列表只有一个元素
int[] 会作为一个数组元素进入 Arrays.asList，不能自动逐项装箱。用准确泛型确认结构，再显式转换为整数列表。
JavaScript 数字数组 sort 后，100 排在 2 前面
普通 JavaScript 数组默认按字符串比较，数字排序可能把 100 放到 2 前面。使用数值比较函数，保留原数组，并明确数字字符串、NaN 和稀疏数组的输入边界。
GitHub Actions 算错发布版本：checkout 只取了一层历史
本地版本计算正常，Actions 却找不到发布标签或错误扩大待发布范围。核对 checkout 的浅历史、标签与发布提交，再用只读版本预览验收。
Java String.split(".") 返回空数组，读取第一个元素时报越界
String.split 的句点参数是正则通配符，配合默认移除尾部空字段会得到空数组。转义字面句点，再按字段契约决定是否保留末尾空值。