Java 的 @file 参数文件中，# 默认被识别为注释起始符；若需将其作为普通字符传递，必须用英文双引号或单引号包裹整个含 # 的参数。
java 的 `@file` 参数文件中，`#` 默认被识别为注释起始符；若需将其作为普通字符传递，必须用英文双引号或单引号包裹整个含 `#` 的参数。
在使用 Java 的命令行参数文件（即通过 java @args.txt 方式传参）时，# 字符具有特殊语义：它标志着该行注释的开始，其后所有内容直至行末均被忽略。这一行为由 JVM 启动器（launcher）直接解析，并非 Java 应用程序逻辑处理。因此，若你希望将字面量 #（例如版本号 v1.2#beta、URL 片段 page.html#section2 或配置键 config#prod）作为真实参数传递给 main(String[] args)，不能直接写 #，也不能用反斜杠 \# 转义——因为 @file 语法不支持反斜杠转义机制。
✅ 正确且唯一可靠的方式是：将含 # 的整个参数用英文双引号 " 或单引号 ' 包裹。JVM 在解析 @file 时会遵循与 JDK_JAVA_OPTIONS 环境变量相同的引用规则：引号内的所有字符（包括空格、#、*、= 等）均被原样保留，仅去除首尾成对引号。
✅ 实际示例
假设 arguments.txt 内容如下：
-classpath . com.example.Main "v2.1#rc" '--profile=dev#staging' "https://example.com/path#anchor"
执行命令：
java @arguments.txt
则 main 方法接收到的 args 数组为：
- args[0] = "com.example.Main"
- args[1] = "v2.1#rc"
- args[2] = "--profile=dev#staging"
- args[3] = "https://example.com/path#anchor"
? 注意：引号本身不会进入参数值——它们仅是解析边界标记。如上例中，args[1] 的真实值就是 v2.1#rc（不含引号）。
⚠️ 常见错误与注意事项
- ❌ 不要尝试 \#：@file 不支持反斜杠转义，\# 会被当作两个独立字符（字面 \ + 字面 #），且 \ 可能引发解析异常或被误判为路径分隔符。
- ❌ 避免不配对引号：若写 "arg#1（缺结尾引号），JVM 将报错并中止启动，提示类似 Error: Invalid argument file: arguments.txt (unmatched quote)。
- ❌ 不可混用引号嵌套：如 "text 'inner#comment'" 不被支持；@file 仅识别最外层成对的单/双引号，内部引号视为普通字符。
- ✅ 空格与 # 可共存于同一引号内：例如 "my config#v3 test" 是合法参数，完整传递为字符串 my config#v3 test。
- ✅ 适用于所有受支持的 JVM 版本：该行为自 Java 9 引入 @file 功能起即已标准化，兼容 Java 9–21+（含 LTS 与最新版）。
? 进阶提示：自动化生成安全参数文件
若需动态生成含 # 的参数文件（如 CI/CD 流水线中），推荐使用带引号保护的模板工具（如 Bash 的 printf %q 或 Python 的 shlex.quote()），确保任意用户输入（含 #, 空格, $, ! 等）均被安全包裹：
# Bash 示例：安全写入含 # 的参数 VERSION="1.5#snapshot" printf '"%s"\n' "$VERSION" >> arguments.txt
总之，引号是 @file 中表达字面 # 的黄金法则。掌握这一简洁机制，即可在构建脚本、容器启动配置或 IDE 运行配置中，安全、清晰、跨平台地传递任意含特殊符号的 Java 启动参数。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
