Monaco Editor中的行号复制功能：快速复制行号信息
项目地址: https://gitcode.com/gh_mirrors/mo/monaco-editor 引言：代码行号复制的痛点与解决方案
在日常的代码开发和协作过程中，我们经常需要与团队成员交流特定代码行的问题或分享代码片段。传统的做法是手动记录行号并告知对方，这种方式不仅效率低下，还容易出错。特别是当代码文件较长或需要引用多个分散的行号时，手动管理行号信息会变得非常繁琐。
Monaco Editor作为一款功能强大的浏览器端代码编辑器（Code Editor），提供了丰富的API和灵活的配置选项，使得实现行号复制功能成为可能。本文将详细介绍如何在Monaco Editor中实现行号复制功能，帮助开发者快速获取和分享代码行号信息，提升团队协作效率。
读完本文后，你将能够：
- 了解Monaco Editor中行号显示的基本原理
- 掌握三种不同的行号复制实现方法
- 学会如何自定义行号复制的格式和行为
- 解决行号复制功能实现过程中的常见问题
Monaco Editor行号系统概述
行号显示机制
Monaco Editor的行号显示由lineNumbers配置项控制，该选项可以设置为以下值：
on：显示行号off：隐藏行号relative：显示相对行号（当前行显示实际行号，其他行显示与当前行的相对差值）interval：每隔一定行数显示行号（默认间隔为10行）
const editor = monaco.editor.create(document.getElementById('container'), {
value: 'function hello() {\n\tconsole.log("Hello, world!");\n}',
language: 'javascript',
lineNumbers: 'on' // 显示行号
});
行号渲染结构
Monaco Editor的行号区域在DOM中通过.monaco-gutter类标识，每个行号由.monaco-gutter-element类的元素表示。典型的DOM结构如下：
<div class="monaco-gutter">
<div class="monaco-gutter-element" style="top: 0px;">1</div>
<div class="monaco-gutter-element" style="top: 21px;">2</div>
<div class="monaco-gutter-element" style="top: 42px;">3</div>
<!-- 更多行号元素 -->
</div>
这种结构为我们实现行号复制功能提供了多种可能的途径，既可以通过Monaco Editor的API获取行号信息，也可以直接操作DOM元素实现复制功能。
行号复制功能实现方法
方法一：基于选区的行号复制
这种方法通过监听编辑器的选区变化事件，当用户选中文本时，自动计算选区包含的行号范围，并提供复制按钮。
实现步骤
- 监听编辑器的
onDidChangeCursorSelection事件 - 获取选区的起始行和结束行
- 生成行号范围文本（如"5-12"或"8"）
- 创建复制按钮并添加点击事件处理程序
代码实现
// 监听选区变化事件
editor.onDidChangeCursorSelection(function(event) {
const selection = event.selection;
if (!selection.isEmpty()) {
const startLine = selection.startLineNumber;
const endLine = selection.endLineNumber;
// 生成行号范围文本
let lineNumbersText;
if (startLine === endLine) {
lineNumbersText = startLine.toString();
} else {
lineNumbersText = `${startLine}-${endLine}`;
}
// 更新复制按钮状态
updateCopyButton(lineNumbersText);
} else {
// 隐藏复制按钮
hideCopyButton();
}
});
// 更新复制按钮
function updateCopyButton(text) {
let copyButton = document.getElementById('lineNumbersCopyButton');
if (!copyButton) {
// 创建复制按钮
copyButton = document.createElement('button');
copyButton.id = 'lineNumbersCopyButton';
copyButton.textContent = '复制行号';
copyButton.style.position = 'absolute';
copyButton.style.top = '10px';
copyButton.style.right = '10px';
copyButton.style.zIndex = '1000';
document.getElementById('container').appendChild(copyButton);
// 添加点击事件处理程序
copyButton.addEventListener('click', function() {
navigator.clipboard.writeText(text).then(function() {
// 显示复制成功提示
const originalText = copyButton.textContent;
copyButton.textContent = '已复制!';
setTimeout(() => {
copyButton.textContent = originalText;
}, 2000);
});
});
} else {
// 更新按钮文本
copyButton.textContent = `复制行号: ${text}`;
// 显示按钮
copyButton.style.display = 'block';
}
}
// 隐藏复制按钮
function hideCopyButton() {
const copyButton = document.getElementById('lineNumbersCopyButton');
if (copyButton) {
copyButton.style.display = 'none';
}
}
优缺点分析
优点：
- 实现简单，不需要深入了解Monaco Editor内部API
- 与用户选择操作自然结合，符合直觉
- 不会干扰编辑器的默认行为
缺点：
- 只能复制连续的行号范围
- 需要用户先选择文本，无法直接点击行号复制
- 自定义样式可能与编辑器主题冲突
方法二：自定义行号渲染器
这种方法通过自定义Monaco Editor的行号渲染器，在行号旁边添加复制图标，实现点击单个行号进行复制的功能。
实现步骤
- 使用
editor.createDecorationsCollection()创建装饰集合 - 定义行号装饰的样式和内容
- 监听行号区域的点击事件
- 根据点击位置确定要复制的行号
代码实现
// 创建装饰集合
const decorations = editor.createDecorationsCollection();
// 更新行号装饰
function updateLineNumberDecorations() {
const lineCount = editor.getModel().getLineCount();
const decorationsArray = [];
for (let i = 1; i <= lineCount; i++) {
decorationsArray.push({
range: new monaco.Range(i, 1, i, 1),
options: {
isWholeLine: true,
lineNumberDecorationsClassName: 'custom-line-number',
glyphMarginClassName: 'line-number-copy-glyph'
}
});
}
decorations.set(decorationsArray);
}
// 初始化时更新装饰
updateLineNumberDecorations();
// 监听模型内容变化，更新装饰
editor.getModel().onDidChangeContent(function() {
updateLineNumberDecorations();
});
// 添加CSS样式
const style = document.createElement('style');
style.textContent = `
.line-number-copy-glyph {
position: relative;
}
.line-number-copy-glyph::after {
content: "📋";
opacity: 0.3;
cursor: pointer;
position: absolute;
right: 5px;
transition: opacity 0.2s;
}
.line-number-copy-glyph:hover::after {
opacity: 1;
}
`;
document.head.appendChild(style);
// 监听编辑器的点击事件
editor.onMouseDown(function(event) {
if (event.target.detail?.glyphMarginClassName === 'line-number-copy-glyph') {
const lineNumber = event.target.position.lineNumber;
navigator.clipboard.writeText(lineNumber.toString()).then(function() {
// 显示复制成功反馈
showCopyNotification(lineNumber);
});
return true; // 阻止事件冒泡
}
return false;
});
// 显示复制成功通知
function showCopyNotification(lineNumber) {
const notification = document.createElement('div');
notification.textContent = `已复制行号: ${lineNumber}`;
notification.style.position = 'absolute';
notification.style.backgroundColor = 'rgba(0, 128, 0, 0.8)';
notification.style.color = 'white';
notification.style.padding = '5px 10px';
notification.style.borderRadius = '3px';
notification.style.zIndex = '1000';
notification.style.transition = 'opacity 0.5s';
// 获取行号位置
const lineTop = editor.getTopForLineNumber(lineNumber);
notification.style.top = `${lineTop}px`;
notification.style.left = '50px';
document.getElementById('container').appendChild(notification);
// 3秒后移除通知
setTimeout(() => {
notification.style.opacity = '0';
setTimeout(() => {
notification.remove();
}, 500);
}, 2000);
}
优缺点分析
优点：
- 提供直观的点击界面，用户体验好
- 可以单独复制某一行的行号
- 装饰器系统与编辑器集成度高
缺点：
- 实现相对复杂，需要理解Monaco Editor的装饰器系统
- 无法直接复制多行号范围
- 自定义图标可能与编辑器主题不匹配
方法三：右键菜单集成
这种方法通过扩展Monaco Editor的右键菜单，添加"复制行号"选项，实现通过右键菜单复制行号的功能。
实现步骤
- 使用
monaco.editor.createContextKey()创建上下文键 - 使用
monaco.editor.registerCommand()注册命令 - 使用
monaco.editor.addAction()添加右键菜单项 - 实现命令处理函数，复制选中行的行号
代码实现
// 创建上下文键，用于控制菜单项是否显示
const hasSelection = monaco.editor.createContextKey('hasSelection', false);
// 更新上下文键值
editor.onDidChangeCursorSelection(function(event) {
hasSelection.set(!event.selection.isEmpty());
});
// 注册复制行号命令
monaco.editor.registerCommand('editor.copyLineNumbers', function(editor) {
const selection = editor.getSelection();
if (!selection.isEmpty()) {
const startLine = selection.startLineNumber;
const endLine = selection.endLineNumber;
let lineNumbersText;
if (startLine === endLine) {
lineNumbersText = startLine.toString();
} else {
lineNumbersText = `${startLine}-${endLine}`;
}
navigator.clipboard.writeText(lineNumbersText).then(function() {
// 显示状态消息
editor.updateOptions({
statusBarMessage: `已复制行号: ${lineNumbersText} (2秒后消失)`
});
setTimeout(() => {
editor.updateOptions({ statusBarMessage: null });
}, 2000);
});
}
});
// 添加右键菜单项
editor.addAction({
id: 'copyLineNumbers',
label: '复制行号',
command: 'editor.copyLineNumbers',
contextMenuGroupId: '9_cutcopypaste', // 将菜单项放在复制粘贴组
contextMenuOrder: 2, // 菜单项顺序
// 控制菜单项何时显示
precondition: 'hasSelection',
// 键盘快捷键（可选）
keybindings: [
monaco.KeyMod.CtrlCmd | monaco.KeyMod.Shift | monaco.KeyCode.KeyC
]
});
优缺点分析
优点：
- 符合用户习惯的操作方式
- 可以复制连续的行号范围
- 与编辑器的其他操作保持一致性
缺点：
- 需要用户先选择文本再打开右键菜单
- 无法复制非连续的多个行号
- 快捷键可能与其他操作冲突
行号复制功能高级定制
自定义复制格式
根据不同的使用场景，我们可能需要复制不同格式的行号信息。以下是几种常见的行号格式及其实现方法：
带文件名的行号格式
// 复制格式如 "filename.js:5-12"
function copyLineNumbersWithFilename(editor, filename) {
const selection = editor.getSelection();
if (!selection.isEmpty()) {
const startLine = selection.startLineNumber;
const endLine = selection.endLineNumber;
let lineNumbersText;
if (startLine === endLine) {
lineNumbersText = `${filename}:${startLine}`;
} else {
lineNumbersText = `${filename}:${startLine}-${endLine}`;
}
navigator.clipboard.writeText(lineNumbersText);
}
}
Markdown链接格式
// 复制格式如 "[filename.js#L5-L12](path/to/filename.js#L5-L12)"
function copyLineNumbersAsMarkdownLink(editor, filename, fileUrl) {
const selection = editor.getSelection();
if (!selection.isEmpty()) {
const startLine = selection.startLineNumber;
const endLine = selection.endLineNumber;
const linePart = startLine === endLine ? `L${startLine}` : `L${startLine}-L${endLine}`;
const lineNumbersText = `[${filename}#${linePart}](${fileUrl}#${linePart})`;
navigator.clipboard.writeText(lineNumbersText);
}
}
代码评审格式
// 复制格式如 "File: filename.js\nLines: 5-12\nCode: function hello() {"
function copyLineNumbersForCodeReview(editor, filename) {
const selection = editor.getSelection();
if (!selection.isEmpty()) {
const startLine = selection.startLineNumber;
const endLine = selection.endLineNumber;
const model = editor.getModel();
// 获取选中的代码内容（最多显示3行）
const maxLinesToShow = 3;
const actualEndLine = Math.min(endLine, startLine + maxLinesToShow - 1);
let codeSnippet = '';
for (let i = startLine; i <= actualEndLine; i++) {
codeSnippet += model.getLineContent(i) + '\n';
}
if (actualEndLine < endLine) {
codeSnippet += `... (共${endLine - startLine + 1}行)`;
}
const lineNumbersText = `File: ${filename}\nLines: ${startLine}-${endLine}\nCode: ${codeSnippet}`;
navigator.clipboard.writeText(lineNumbersText);
}
}
多行号选择复制
对于需要复制多个不连续行号的场景，可以实现一个多行号选择器：
let selectedLineNumbers = new Set();
// 初始化行号装饰
const multiSelectDecorations = editor.createDecorationsCollection();
// 监听行号区域点击
editor.onMouseDown(function(event) {
if (event.target.type === monaco.editor.MouseTargetType.GUTTER_LINE_NUMBER) {
const lineNumber = event.target.position.lineNumber;
// 处理Shift+点击（连续选择）
if (event.event.shiftKey && selectedLineNumbers.size > 0) {
const lines = Array.from(selectedLineNumbers);
const minLine = Math.min(...lines);
const maxLine = Math.max(...lines);
const start = Math.min(minLine, lineNumber);
const end = Math.max(maxLine, lineNumber);
for (let i = start; i <= end; i++) {
selectedLineNumbers.add(i);
}
}
// 处理Ctrl/Cmd+点击（单个选择/取消）
else if (event.event.ctrlKey || event.event.metaKey) {
if (selectedLineNumbers.has(lineNumber)) {
selectedLineNumbers.delete(lineNumber);
} else {
selectedLineNumbers.add(lineNumber);
}
}
// 普通点击（清除之前选择，选择当前行）
else {
selectedLineNumbers.clear();
selectedLineNumbers.add(lineNumber);
}
// 更新装饰
updateMultiSelectDecorations();
// 显示复制按钮
if (selectedLineNumbers.size > 0) {
showMultiSelectCopyButton();
}
return true; // 阻止事件冒泡
}
return false;
});
// 更新多行选择装饰
function updateMultiSelectDecorations() {
const decorations = [];
selectedLineNumbers.forEach(lineNumber => {
decorations.push({
range: new monaco.Range(lineNumber, 1, lineNumber, 1),
options: {
isWholeLine: true,
lineNumberDecorationsClassName: 'multi-selected-line-number'
}
});
});
multiSelectDecorations.set(decorations);
}
// 添加多行选择样式
const style = document.createElement('style');
style.textContent = `
.multi-selected-line-number {
background-color: rgba(255, 255, 0, 0.3);
font-weight: bold;
}
`;
document.head.appendChild(style);
// 显示多行选择复制按钮
function showMultiSelectCopyButton() {
let copyButton = document.getElementById('multiSelectCopyButton');
if (!copyButton) {
copyButton = document.createElement('button');
copyButton.id = 'multiSelectCopyButton';
copyButton.textContent = '复制选中行号';
copyButton.style.position = 'absolute';
copyButton.style.top = '10px';
copyButton.style.right = '10px';
copyButton.style.zIndex = '1000';
copyButton.style.backgroundColor = '#4CAF50';
copyButton.style.color = 'white';
copyButton.style.border = 'none';
copyButton.style.padding = '5px 10px';
copyButton.style.borderRadius = '3px';
copyButton.style.cursor = 'pointer';
document.getElementById('container').appendChild(copyButton);
copyButton.addEventListener('click', function() {
// 将选中的行号排序并格式化为字符串
const sortedLines = Array.from(selectedLineNumbers).sort((a, b) => a - b);
let lineNumbersText = '';
// 合并连续的行号
let start = sortedLines[0];
let end = start;
for (let i = 1; i < sortedLines.length; i++) {
if (sortedLines[i] === end + 1) {
end = sortedLines[i];
} else {
if (start === end) {
lineNumbersText += start + ', ';
} else {
lineNumbersText += start + '-' + end + ', ';
}
start = sortedLines[i];
end = start;
}
}
// 添加最后一组
if (start === end) {
lineNumbersText += start;
} else {
lineNumbersText += start + '-' + end;
}
// 复制到剪贴板
navigator.clipboard.writeText(lineNumbersText).then(function() {
const originalText = copyButton.textContent;
copyButton.textContent = '已复制!';
setTimeout(() => {
copyButton.textContent = originalText;
}, 2000);
});
});
}
// 更新按钮文本，显示选中的行数
copyButton.textContent = `复制选中行号 (${selectedLineNumbers.size}行)`;
copyButton.style.display = 'block';
return copyButton;
}
与版本控制系统集成
将行号复制功能与Git等版本控制系统集成，可以实现更强大的代码引用功能：
// 获取当前文件的Git信息（需要后端支持）
async function getGitInfo(filename) {
try {
const response = await fetch(`/api/git-info?file=${encodeURIComponent(filename)}`);
return response.json();
} catch (error) {
console.error('获取Git信息失败:', error);
return null;
}
}
// 复制带Git信息的行号
async function copyLineNumbersWithGitInfo(editor, filename) {
const gitInfo = await getGitInfo(filename);
if (!gitInfo) {
// 如果无法获取Git信息，使用基本格式
copyBasicLineNumbers(editor, filename);
return;
}
const selection = editor.getSelection();
if (!selection.isEmpty()) {
const startLine = selection.startLineNumber;
const endLine = selection.endLineNumber;
let lineRange = startLine === endLine ? `L${startLine}` : `L${startLine}-L${endLine}`;
// 格式：文件名@提交哈希#行号范围
const lineNumbersText = `${filename}@${gitInfo.commitHash}#${lineRange}`;
navigator.clipboard.writeText(lineNumbersText);
// 同时复制一个可点击的URL（如果可用）
if (gitInfo.remoteUrl) {
const url = `${gitInfo.remoteUrl}/blob/${gitInfo.commitHash}/${filename}#${lineRange}`;
// 使用自定义数据格式复制多个值（需要浏览器支持）
try {
const item = new ClipboardItem({
'text/plain': new Blob([lineNumbersText], { type: 'text/plain' }),
'text/uri-list': new Blob([url], { type: 'text/uri-list' })
});
navigator.clipboard.write([item]);
} catch (error) {
// 回退到仅复制文本
navigator.clipboard.writeText(`${lineNumbersText}\n${url}`);
}
}
}
}
常见问题与解决方案
行号与实际代码不匹配
问题描述：复制的行号与代码实际行号不匹配，特别是在代码折叠或有换行符的情况下。
解决方案：
// 获取可视行号（考虑代码折叠）
function getVisibleLineNumbers(editor) {
const selection = editor.getSelection();
const model = editor.getModel();
// 获取折叠状态
const foldedRanges = model.getFoldedRegions();
// 计算折叠的行数
let foldedLineCount = 0;
for (const range of foldedRanges) {
if (range.startLineNumber < selection.startLineNumber) {
foldedLineCount += range.endLineNumber - range.startLineNumber;
}
}
// 可视起始行号 = 实际起始行号 - 折叠行数
const visibleStartLine = selection.startLineNumber - foldedLineCount;
// 对于结束行号也进行相同计算...
return { visibleStartLine, visibleEndLine };
}
根本解决：始终使用Monaco Editor提供的API获取行号，而不是通过DOM元素或自定义计算：
// 正确的方式：使用editor.getSelection()获取行号
const selection = editor.getSelection();
const startLine = selection.startLineNumber;
const endLine = selection.endLineNumber;
// 错误的方式：通过DOM获取行号
const lineNumberElements = document.querySelectorAll('.monaco-gutter-element');
const lineNumbers = Array.from(lineNumberElements).map(el => parseInt(el.textContent));
大文件性能问题
问题描述：在包含数千行代码的大文件中，行号复制功能可能导致编辑器卡顿。
解决方案：
// 使用节流优化频繁更新的场景
function throttle(func, limit) {
let lastCall = 0;
return function(...args) {
const now = Date.now();
if (now - lastCall >= limit) {
lastCall = now;
return func.apply(this, args);
}
};
}
// 应用节流到内容变化事件
const throttledUpdateDecorations = throttle(updateLineNumberDecorations, 100); // 限制100ms内只能执行一次
editor.getModel().onDidChangeContent(throttledUpdateDecorations);
// 对于非常大的文件，可以只渲染可视区域的装饰
function updateVisibleDecorations(editor) {
const visibleRanges = editor.getVisibleRanges();
const decorationsArray = [];
// 只处理可视区域的行
for (const range of visibleRanges) {
for (let i = range.startLineNumber; i <= range.endLineNumber; i++) {
decorationsArray.push({
range: new monaco.Range(i, 1, i, 1),
options: {
isWholeLine: true,
glyphMarginClassName: 'line-number-copy-glyph'
}
});
}
}
decorations.set(decorationsArray);
}
// 监听滚动事件，更新可视区域装饰
editor.onDidScrollChange(updateVisibleDecorations);
跨浏览器兼容性
问题描述：剪贴板API在某些旧浏览器中不受支持，导致复制功能失效。
解决方案：
// 兼容旧浏览器的复制函数
function copyToClipboard(text) {
// 检查Clipboard API是否可用
if (navigator.clipboard && window.ClipboardItem) {
return navigator.clipboard.writeText(text);
}
// 回退方案：创建临时文本区域
const textarea = document.createElement('textarea');
textarea.value = text;
// 确保文本区域不可见但可选中
textarea.style.position = 'absolute';
textarea.style.left = '-9999px';
textarea.style.opacity = '0';
document.body.appendChild(textarea);
textarea.select();
textarea.setSelectionRange(0, 99999); // 移动设备兼容
try {
const successful = document.execCommand('copy');
if (!successful) {
throw new Error('复制失败');
}
return Promise.resolve();
} catch (error) {
console.error('复制失败:', error);
return Promise.reject(error);
} finally {
document.body.removeChild(textarea);
}
}
// 使用示例
copyToClipboard(lineNumbersText)
.then(() => showSuccessMessage())
.catch(() => showFallbackCopyMethod(lineNumbersText));
// 显示备用复制方法（如果主方法失败）
function showFallbackCopyMethod(text) {
const modal = document.createElement('div');
modal.style.position = 'fixed';
modal.style.top = '50%';
modal.style.left = '50%';
modal.style.transform = 'translate(-50%, -50%)';
modal.style.backgroundColor = 'white';
modal.style.border = '1px solid #ccc';
modal.style.borderRadius = '5px';
modal.style.padding = '20px';
modal.style.zIndex = '10000';
modal.innerHTML = `
<h3>复制行号</h3>
<p>请手动复制以下行号信息：</p>
<textarea style="width: 100%; height: 100px; margin: 10px 0;">${text}</textarea>
<button id="closeFallbackModal" style="padding: 5px 10px; background: #0078d7; color: white; border: none; border-radius: 3px;">关闭</button>
`;
document.body.appendChild(modal);
// 自动选择文本
modal.querySelector('textarea').select();
// 关闭按钮事件
modal.querySelector('#closeFallbackModal').addEventListener('click', () => {
document.body.removeChild(modal);
});
// 点击外部关闭
modal.addEventListener('click', (e) => {
if (e.target === modal) {
document.body.removeChild(modal);
}
});
}
总结与展望
本文详细介绍了Monaco Editor中行号复制功能的三种实现方法，包括基于选区的复制、自定义行号渲染器和右键菜单集成。每种方法都有其适用场景和优缺点，开发者可以根据项目需求选择合适的实现方式。
| 实现方法 | 复杂度 | 用户体验 | 适用场景 |
|---|---|---|---|
| 基于选区的复制 | 简单 | 中等 | 快速复制连续行号范围 |
| 自定义行号渲染器 | 中等 | 良好 | 单个行号快速复制 |
| 右键菜单集成 | 简单 | 良好 | 需要保持界面简洁的场景 |
通过自定义复制格式、实现多行号选择复制和与版本控制系统集成，可以进一步扩展行号复制功能的应用范围。同时，解决行号不匹配、性能问题和浏览器兼容性等常见问题，可以确保功能的稳定性和可靠性。
未来，随着Monaco Editor的不断发展，我们可以期待更多原生支持的行号操作功能。例如，行号区域的自定义交互事件API、更灵活的装饰器系统以及与IDE功能的深度集成等。作为开发者，我们也应该持续关注编辑器的更新，及时采用新的API和最佳实践来优化行号复制等辅助功能。
最后，无论采用哪种实现方式，都应该以用户体验为中心，确保行号复制功能既强大又易用，真正帮助开发者提高工作效率和团队协作质量。
扩展学习资源
- Monaco Editor官方文档：https://microsoft.github.io/monaco-editor/docs.html
- Monaco Editor API参考：https://microsoft.github.io/monaco-editor/api/index.html
- Monaco Editor GitHub仓库：https://github.com/microsoft/monaco-editor
- VS Code扩展开发文档：https://code.visualstudio.com/api
- Monaco Editor装饰器示例：https://microsoft.github.io/monaco-editor/playground.html#interacting-with-the-editor-line-decorations
希望本文能帮助你更好地理解和使用Monaco Editor的行号功能。如果你有任何问题或建议，欢迎在评论区留言讨论。如果你觉得本文对你有帮助，请点赞、收藏并关注我，获取更多关于Monaco Editor和前端开发的优质内容。
下期预告：《Monaco Editor自定义语言支持完全指南》—— 教你如何为Monaco Editor添加对自定义编程语言的支持，包括语法高亮、代码补全和错误检查等功能。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
