开发工具
共 415 篇文章
npm 编译原生模块报 No module named distutils：旧 node-gyp 遇到 Python 3.12
npm 编译原生模块遇到 distutils 缺失时，检查实际 node-gyp 与 Python 路径。Python 3.12 需兼容构建工具，更新被调用的依赖链，保留临时环境与原生 ABI 验收边界。
AutoGen 交接目标名带空格，运行时才报 Invalid name
AutoGen 0.7.5 自动生成的交接工具名含空格时，核对工具命名、目标 Agent 与参与者一致性，保留长度、重名和版本边界。
Git 2.33.1 本地仅领先远程，pull 仍报无法快进
Git 2.33.1 中，本地仅领先远程时 pull --ff-only 可能误报无法快进。核对祖先关系，临时拆分 fetch 与 merge，并确认实际修复版本。
pip 报 No module named _ssl：装 OpenSSL 不会补回 Python 扩展
pip 缺少 _ssl 先确认实际解释器与扩展构建。区别 CA 验证失败，按分发或独立构建流程修复，保留 OpenSSL 版本与运行时边界。
Bash 中 curl 请求突然进入后台，URL 后半段参数丢失
Bash 中未加引号的 URL 含有 & 时，会把 curl 放到后台并截断后续查询参数。用正确引号传递完整地址，区分参数编码，并在前台核对退出状态和实际请求。
Pydantic 2 的 Optional 字段没传，为什么仍报 Field required
Pydantic 2 区分允许 None 和允许省略。按字段默认值核对必填规则，部分更新用 exclude_unset 保留省略与显式清空的区别。
Bash 中 curl 管道失败后继续执行，脚本却返回成功
Bash 中 curl 接 jq 后，请求失败可能被下游或最后一条命令的成功状态掩盖。用 pipefail 和显式状态累计，让多个请求继续执行，并在末尾统一返回失败；同时区分 curl 与 jq 的退出码。
Python 报 cannot reuse already awaited coroutine：区分重跑与共享任务
协程对象结束后不能重新等待执行。定时调用用函数或工厂创建新协程，共享同一次执行用 Task，并明确重复副作用、取消、失败缓存与循环生命周期。
Spring Boot 升级后报 Name for argument 错误
控制器升级后无法发现形参名时，显式指定请求名称，或在实际编译模块启用 -parameters。区分请求值缺省、编译设置与最终部署产物。
Git 推送被拒绝：shallow update not allowed
Git 推送出现 shallow update not allowed 时，确认实际发送端的浅历史状态，从完整来源补全，并检查 CI 同步步骤是否再次截断历史。区分接收端策略与客户端获取选项。
Python 3 对 dict.values() 使用下标报 not subscriptable
dict.values() 是可迭代的动态视图。根据读取需求选择先转列表、next 取值或按键访问，并处理空字典、插入顺序和浅复制边界。
Spring Boot 同类方法调用时 @Transactional 为什么不生效
同类内部调用绕过 Spring 事务代理。按整个业务入口或独立 Bean 调整边界，区分外层已有事务、REQUIRED 与内层注解失效。
GitHub 分支已删除，git branch -a 仍显示 origin 分支
GitHub 删除分支后，git branch -a 仍可能显示本地保存的 origin 引用。核对远程状态和 refspec，先预览 prune 范围，再清理，并保留独立的本地开发分支。
pull_request 中 git branch 显示 detached HEAD
PR 工作流检出合并测试引用时可能处于 detached HEAD。区分读取源分支名、创建本地分支与检出源 SHA，保持测试输入和权限边界。
Python 调用异步函数没有执行，提示 coroutine was never awaited
直接调用 async def 函数只创建协程对象。按当前入口选择 asyncio.run 或 await，需要任务时保留引用并等待结果，避免用忽略警告代替修复。
PyTorch 装好了，torch.cuda.is_available() 为什么还是 False
CUDA Toolkit 已安装，PyTorch 仍看不到 GPU。按实际解释器、CUDA 构建、驱动与设备可见性检查，并区分可用性检测与实际内核兼容。
GitHub Desktop 报 Filename too long：系统 Git 配置未必被使用
Desktop 克隆报 Filename too long 而终端正常时，核对系统与用户配置作用域，缩短目标目录，并确认长路径开关及其工具链限制。
Java 对 Arrays.asList 返回的列表调用迭代器 remove 报 UnsupportedOperationException
Arrays.asList 返回固定大小的数组视图，迭代器不能删除元素。按需复制为 ArrayList，并检查原数组关联、元素引用与迭代器调用顺序。
LazyColumn 报 infinity maximum height
LazyColumn 报无限高度异常时，按整页滚动、固定页头或独立面板选择布局，统一 LazyColumn 内容，并沿父级排查无界测量约束。
curl 加了 --create-dirs，保存响应头仍报 Failed to open
curl 早于 8.11.0 时，--create-dirs 不会为响应头文件创建目录。区分本地写入失败、输出路径与版本边界，并给出兼容旧版本的目录准备方法。