Java new URL(...)未转义首个字符，Github Issue链接转义异常求助

问题原因分析 #

你遇到的这个奇怪现象，核心原因是URL中#的特殊作用：当你手动把包含#的Markdown内容直接拼接到GitHub Issue的URL查询参数里时，第一个#会被URL解析器识别为锚点（Hash）的起始标记，而不是body参数的一部分。

这就导致了：

• 第一个#被从body参数中剥离出来，变成了URL结构的一部分（用来分隔查询参数和锚点），所以它不会被转义；
• 后面的#因为落在了锚点区域内，会按照URL锚点的规则被处理（转义），但这部分内容已经不属于body参数了，自然无法被GitHub正确识别为Issue内容。

解决方案 #

推荐使用URLSearchParams来安全构造链接，它会自动处理所有特殊字符的URL编码，完全避免这类问题。

方法一：使用URLSearchParams（推荐）

// 你的Markdown格式的Issue内容
const issueBody = `# 问题主标题
## 问题详情
这里可以写具体的问题描述、复现步骤等...`;

// 初始化GitHub新建Issue的基础URL（替换成你的仓库地址）
const baseUrl = new URL('https://github.com/你的用户名/你的仓库名/issues/new');

// 用URLSearchParams设置body参数，自动编码特殊字符
baseUrl.searchParams.set('body', issueBody);

// 生成最终可直接使用的链接
const finalIssueUrl = baseUrl.toString();
console.log(finalIssueUrl);

这样处理后，所有的#会被转义为%23，换行符转义为%0A，GitHub会自动解码这些内容，并在新建Issue页面中正确渲染成Markdown格式。

方法二：手动编码参数（不推荐）

如果因为某些原因必须手动拼接URL，一定要用encodeURIComponent()对body内容做完整编码：

const issueBody = `# 问题主标题\n## 问题详情`;
// 对整个内容做URL编码
const encodedBody = encodeURIComponent(issueBody);
// 拼接成完整URL
const finalIssueUrl = `https://github.com/你的用户名/你的仓库名/issues/new?body=${encodedBody}`;

为什么推荐URLSearchParams？ #

它不仅能处理#，还能自动处理其他URL特殊字符（比如空格、换行、&等），避免手动编码时遗漏或出错，是处理URL参数的标准安全方式。

内容的提问来源于stack exchange，提问作者Marcel