Comments starting with /// should not be reformatted as // /

未关闭

#1,215 创建于 2024年12月29日 4 条评论 2 个 reaction 已指派 0 人在 GitHub 查看

还没有人认领这个 Issue。

评估

难度: 3/5
预计耗时: 1-2 天
新手友好度: 38/100

Issue 类型: 缺陷
描述清晰度: 基本清楚
活跃度: 停滞
技术栈: java
领域: tooling

调研方向

使用 google-java-format 重现所报告的 ///usr/bin/env jbang "$0" "$@" ; exit $? 头部格式，并比较输出。跟踪格式化程序对以 /// 开头的注释的处理行为；当 shebang 风格的行保持完全不变，同时保留普通注释的格式时，即视为完成。

由索引模型根据 Issue 内容生成。

描述

I'm toying (more "for fun") with ~~https://openjdk.org/jeps/330~~ something in https://github.com/enola-dev/enola/issues/971:

I am using https://www.jbang.dev, but Im not sure if this issue specific to that tool or really could be considered more generically:

As per https://www.jbang.dev/documentation/guide/latest/faq.html, and (apparently) partly inspired by https://golangcookbook.com/chapters/running/shebang/ in Go, given that JEP 330 "shebang" headers are still a bit of a PITA (see also related #1214), I'm starting a Java file with ///usr/bin/env jbang "$0" "$@" ; exit $?

google-java-format reformats ///usr/bin/env jbang "$0" "$@" ; exit $? to /// usr/bin/env jbang "$0" "$@" ; exit $? (note the added space), which breaks the magic.

Unfortunately, as per https://github.com/google/google-java-format/wiki/FAQ#why-cant-i-use-magic-comments-to-disable-formatting-for-certain-sections-of-code, it does not seem to be easily possible to suppress formatting that first line.

The only choice seems to be not to use google-java-format for such "script" like Java files (shame), or not to use that header in them.

主要语言: Java
星标: 6.2k
派生: 936
平均合并: 6 分钟
30 天内合并 PR: 3

贡献指南

打开贡献指南

从这里开始

先读完整个 Issue，再读项目的贡献指南。
在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
Fork 仓库，在一个分支上完成修改。
提交 Pull Request，并在描述里引用这个 Issue 编号。

google/google-java-format 的其他 Issue

Misleading message for --dry-run with --replace 未关闭

难度 2/5 1-3 小时新手友好度 72/100

google/google-java-format#1094 · 1 条评论 · 2024年4月7日创建
Complementary Teamups 未关闭

难度 5/5 一周以上新手友好度 15/100

google/google-java-format#1450 · 1 个 reaction · 2026年9月6日创建
IndexOutOfBoundsException - Wrong formatted content when dealing with latex String 未关闭

难度 4/5 3-5 天新手友好度 55/100

google/google-java-format#1439 · 1 条评论 · 2026年8月6日创建
unused import removal leaves extra blank line between package declaration and class Javadoc / declaration 未关闭

难度 3/5 1-2 天新手友好度 62/100

google/google-java-format#1436 · 2 条评论 · 2026年8月4日创建
Possible issue with Eclipse plugin 未关闭

难度 3/5 1-2 天新手友好度 48/100

google/google-java-format#1428 · 3 条评论 · 2026年7月30日创建

查看 google/google-java-format 的全部 Issue

相似的 Issue

[Bug][UI] Change the method of opening the Action Detail 未关闭

难度 2/5 1-3 小时新手友好度 65/100

Netcracker/qubership-integration-platform#913 · 2026年9月23日创建
SEC-CORS-006 declares MEDIUM but can only emit HIGH or LOW 未关闭

bug

难度 2/5 1-3 小时新手友好度 75/100

jdubois/boot-ui#1100 · 2026年9月23日创建
build-scan-xunit: accept ISO offset timestamps in test reports 未关闭

难度 2/5 1-3 小时新手友好度 75/100

elastic/gradle-plugins#157 · 2026年9月23日创建
OpenAPI document marks optional request body of `PUT /api/users/me` as required 未关闭

难度 2/5 1-3 小时新手友好度 75/100

cryptomator/hub#497 · 2026年9月23日创建
No test covers the claim that only the last command's state is checked 未关闭

难度 2/5 1-3 小时新手友好度 75/100

johanhaleby/occurrent#1120 · 2026年9月23日创建

更多 Java Issue