Document false -race failures with Go 1.26.0 on Windows
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 1/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 88/100
- Issue 类型
- 文档
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- go
调研方向
从 CONTRIBUTING 和 Developer Guide 开始，这两个是 issue 中提到的贡献者文档位置。说明 Windows Go 1.26.0 可能导致 race 测试误报失败，并记录建议使用 Go 1.26.3 或更高版本运行的命令：GOTOOLCHAIN=go1.26.3 go test -race ./...。当两份贡献者文档都说明该问题及其避免方法时，即为完成。
由索引模型根据 Issue 内容生成。
描述
Why it matters
Contributors on Windows running Go 1.26.0 get -race failures that are not bugs in subenum. Without a note, they will spend time chasing races that do not exist, as happened while #76 was developed.
Evidence
On Windows with go1.26.0, go test -race -count=10 intermittently fails on an untouched main:
internal/scan: "WARNING: DATA RACE" betweencontext.WithTimeout(called frominternal/dns/resolver.go:277) and the net package's DNS lookup goroutine (net/dnsclient_unix.go:677). The two stack traces touch the same address from unrelated objects.TestPoolBenchesDeadResolverfails with it.- The root package's e2e tests:
Exception 0xc0000005crashes with a garbage PC insidescan.Run's deferred-call return.
With GOTOOLCHAIN=go1.26.3, the same runs are clean (30 runs each of internal/scan and the lab e2e tests). CI runs -race on Linux and is not affected.
Suggested approach
- Add a note to CONTRIBUTING and the Developer Guide: on Windows, run race tests with Go 1.26.3 or later (
GOTOOLCHAIN=go1.26.3 go test -race ./...). - Keep the
go 1.26.0directive ingo.mod, which CI requires. Optionally add atoolchain go1.26.3line, if the "Check go directive" step allows it.
Done when
The contributor docs explain the false positives and how to avoid them.
- 主要语言
- Go
- 星标
- 1
- 派生
- 1
- 平均合并
- 5 天 2 小时
- 30 天内合并 PR
- 3
环境准备
在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。
- 提供 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
TMHSDigital/subenum 的其他 Issue
-
area: cli enhancement good first issue
难度 2/5 1-3 小时 新手友好度 88/100
TMHSDigital/subenum#136 ·
维护者通常 1 天内回复
-
community documentation good first issue
难度 2/5 1-3 小时 新手友好度 85/100
TMHSDigital/subenum#135 ·
维护者通常 1 天内回复
-
area: dns enhancement good first issue
难度 2/5 1 小时以内 新手友好度 90/100
TMHSDigital/subenum#134 ·
维护者通常 1 天内回复
-
community marketing priority: low
难度 5/5 一周以上 新手友好度 35/100
TMHSDigital/subenum#132 · 1 条评论 ·
维护者通常 1 天内回复
-
feature priority: low
难度 5/5 一周以上 新手友好度 35/100
TMHSDigital/subenum#131 ·
维护者通常 1 天内回复
查看 TMHSDigital/subenum 的全部 Issue
相似的 Issue
-
难度 1/5 1 小时以内 新手友好度 82/100
homarr-labs/dashboard-icons#2939 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 66/100
AvengeMedia/DankMaterialShell#3761 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 77/100
维护者通常 1 天内回复
-
docs: clarify replacement for outdated Terms of Service URL in readme.md可能已有人在做 @mohitjoshi-hey 今天认领。 未关闭
难度 1/5 1-3 小时 新手友好度 66/100
-
难度 2/5 1-3 小时 新手友好度 68/100
runkids/skillshare#530 ·
维护者通常 1 天内回复