1.7 文本编辑

一、文件内容与文档格式

1.1 纯文本、富文本与版式文档

文件并不只分成“纯文本”和“富文本”两类。日常接触的文件，大体是下面三种形态：

二、字符编码

2.1 字符、编码与解码

字符编码定义字符与字节序列之间的映射。把字符转换为字节称为编码，把字节还原为字符称为解码，将文本从一种编码转换为另一种编码称为转码。

正确转码会先按源编码解码，再按目标编码重新编码。例如，把 GBK 文件转换为 UTF-8 时，必须先确认源文件确实是 GBK；直接把 GBK 字节当成 UTF-8 读取并不是转码，而是错误解码。

2.2 常见编码对比

2.3 乱码是如何产生的

同一串字节交给不同解码器，可能得到完全不同的文本，也可能因字节序列不合法而产生错误。下表中的箭头表示错误解码，不是正确转码；结果由解码器的错误处理策略决定，这里以常见的“使用 U+FFFD 替换无法解码的字节”为例。

UTF-8 字节误按 GBK 解码时，有些字节组合恰好能映射为 GBK 字符，因此常出现 浣犲ソ 这类可读但无意义的汉字；不合法或无法配对的字节仍可能显示为 �。GBK 字节误按 UTF-8 解码时，许多字节序列不符合 UTF-8 规则，编辑器可能报错、拒绝打开，或显示一个或多个 �，不能把结果概括成固定数量的替换字符。

2.4 编码约定与 BOM

BOM（Byte Order Mark，字节序标记）是写在文件开头的一组特殊字节，用于标记编码方式。UTF-16 的 BOM 用于区分字节序：以 FF FE 开头表示 UTF-16 LE，以 FE FF 开头表示 UTF-16 BE。UTF-8 不存在字节序问题，它的 BOM（EF BB BF）只作为编码签名，帮助工具识别文件是 UTF-8。

• 新项目优先采用 UTF-8；VS Code 默认使用不带 BOM 的 UTF-8
• 是否使用 BOM 取决于文件格式、协议和工具链要求；UTF-8 不存在字节序问题，BOM 在其中只作为编码签名
• 团队应通过项目文档、编辑器配置或工具链明确编码；.editorconfig 只有在仓库实际采用并被相关工具支持时才有效
• 旧式工具、课程评测系统或历史文件可能要求 GBK 等编码，不能未经确认直接批量转为 UTF-8

三、换行符

3.1 常见换行符

文本文件常见的行结束序列有两种：

换行符不一致不会造成字符乱码，但可能让 Git 将每一行都识别为已修改。Shell 脚本的 shebang（解释见 1.12 Shell 基础）或命令末尾若带有多余的 \r，在类 Unix 环境中还可能出现 bad interpreter、command not found 等错误。

3.2 跨平台协作的处理

项目可以在根目录使用 .gitattributes 明确换行规则。该文件随仓库提交，比每位成员各自配置更容易保持一致：

# 自动识别文本文件，并在 Git 索引中规范为 LF
* text=auto
# 签出到工作区时，Shell 脚本使用 LF，批处理文件使用 CRLF
*.sh text eol=lf
*.bat text eol=crlf
*.cmd text eol=crlf

eol 控制文件签出到工作区时的行结束符；被识别为文本的文件在 Git 索引中会规范为 LF。仓库没有约定时，个人配置 core.autocrlf 才会参与决定转换行为。修改全局设置前可查看当前值：

# 未配置时可能没有输出
git config --global --get core.autocrlf

四、VS Code：下载、安装与首次使用

本节只介绍 VS Code 的安装与基础使用；编译器等环境配置将在 1.14 Windows 环境配置 中介绍。

4.1 下载与安装

到 VS Code 官网下载页，根据 CPU 架构选择 x64 或 Arm64。System Installer 安装包进行下载。

运行安装程序并阅读每一步的选项。推荐勾选 「将“通过Code打开”操作添加到Windows资源管理器文件上下文菜单」与 「将“通过Code打开”操作添加到Windows资源管理器目录上下文菜单」。

安装程序默认会将 code 命令加入 PATH；安装完成后需要重新打开终端，才能用 code . 打开当前文件夹。快捷方式和文件关联可按实际需要选择。

验证安装： 从开始菜单启动 VS Code；也可重新打开终端，执行 code --version 检查命令是否可用。

4.2 安装中文语言包

习惯英文界面的读者可以跳过本节。其余读者：

1. 打开侧边栏的「扩展」面板（Ctrl + Shift + X）
2. 搜索 Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code
3. 点击「安装」，完成后点击 Change Language And Restart，VS Code 会自动重启并切换为简体中文

4.3 界面速览与常用入口

常用入口：

• 打开文件夹：Ctrl + K，松开后再按 Ctrl + O（「文件 → 打开文件夹」）
• 集成终端：Ctrl + `（「终端 → 新建终端」）
• 命令面板：Ctrl + Shift + P（详见下文）

五、VS Code 进阶技巧

5.1 多光标编辑

多光标可以同时编辑多个位置。以下是 Windows 默认键位；快捷键可能被显卡驱动、系统工具或自定义键位覆盖：

例如，需要修改若干处相同文本时，可选中其中一处并按 Ctrl + D 逐个加入匹配项；遇到不应修改的位置，按 Ctrl + K，松开后按 Ctrl + D 跳过当前匹配。确认所有选区都正确后再输入替换内容。

5.2 查找与替换

点击查找框中的 .* 图标可启用正则表达式。例如，下列规则能匹配单行且参数中不含右括号的简单 console.log(...) 调用，并保留括号内的内容：

查找: console\.log\(([^\r\n()]*)\)
替换: console.debug($1)

这不是通用的 JavaScript 代码转换规则：console.log(fn())、跨行参数、字符串中的右括号等情况都可能无法正确处理。 执行全项目替换前应先查看预览；涉及代码结构时应使用语言服务、AST 工具或逐项确认。

5.3 正则表达式

查找与替换的进阶玩法是正则表达式（Regular Expression），用符号描述匹配模式，一次就能匹配一整类文本，而不是逐字查找。VS Code 查找框右上角的 .* 图标即是开启正则的开关。

常用元字符：

要点：

• .、*、(、|、\ 等在正则中都有特殊含义；要匹配符号本身，需在前面加 \ 转义（如 \.、\(）。
• ( ... ) 会把匹配到的内容存成捕获组，替换时用 $1、$2 依次引用。例如把日期格式从 2024-11-15 改成 2024/11/15：

查找: (\d{4})-(\d{2})-(\d{2})
替换: $1/$2/$3

• 通配符不是正则。1.12 Shell 基础 中的 *.cpp 用于匹配一整段文件名，而正则匹配任意文本片段，并可用 \d+、(ab)+ 等描述更复杂的模式。
• 不同工具的正则语法并不完全相同：VS Code 使用 Rust 正则引擎，. 不匹配换行；grep 默认使用“基础正则（BRE）”，其中 +、( 等要写成 \+、\( 才有特殊含义。用到某个工具前，先看它的语法说明。

5.4 代码片段（Snippet）

经常重复输入的代码块可以做成代码片段，输入几个字母按 Tab 自动展开。在 VS Code 中：Ctrl + Shift + P → Configure User Snippets → 选择语言。

例如为 C++ 新建一个快速输出片段：

{
  // 快速插入 cout 语句
  "Print": {
    "prefix": "cout",
    "body": ["std::cout << ${1:内容} << std::endl;"],
    "description": "快速插入 cout 语句"
  }
}

之后输入 cout 按 Tab，就会自动展开，并把光标停在 ${1:内容} 处等待输入。

5.5 命令面板

Ctrl + Shift + P 打开命令面板。它会列出当前环境中已注册的命令，适合按关键词查找设置入口和操作，不必记住每一层菜单。

5.6 其他常用快捷键速览

以下操作可通过默认快捷键或命令面板调用：

常用设置既可以只作用于当前用户，也可以随项目共享。

六、编辑器配置与同步

6.1 JSON 配置文件

VS Code 同时提供图形化设置界面和 JSON 配置文件。JSON 适合精确编辑、审查差异和共享工作区配置：

• 用户设置：Ctrl + Shift + P → Preferences: Open User Settings (JSON)
• 工作区设置：项目 .vscode/settings.json，只对当前项目生效

常用配置示例：

{
  // 字体大小
  "editor.fontSize": 14,
  // 缩进位数
  "editor.tabSize": 4,
  // 保存时自动格式化
  "editor.formatOnSave": true,
  // 自动换行
  "editor.wordWrap": "on",
  // 延迟自动保存
  "files.autoSave": "afterDelay",
  // 终端字体大小
  "terminal.integrated.fontSize": 13
}

6.2 设置同步

登录 GitHub 或 Microsoft 账户后，可以按需开启 Settings Sync。 可同步的项目以当前版本界面为准，通常包括设置、快捷键、用户代码片段和扩展信息，并可分别启用或停用。 它不包含项目文件，不能替代 Git 或备份；WSL、SSH 和开发容器中的远程扩展也需要在对应目标环境中确认。

七、其他编辑器

本节使用 VS Code，我们也可使用其他的编辑器与 IDE。

7.1 编辑器 vs IDE

两类工具的边界并不绝对：VS Code 安装语言扩展后也能提供调试和重构能力，IDE 也可以精简界面与插件。选择标准应是项目支持、语言工具链、团队约定和资源占用，而不是工具类别本身。

7.2 推荐选择

具体功能、系统要求和授权政策会变化，安装前应查阅产品官网；学生授权也不等同于产品永久免费。

八、TODO 清单

• 了解纯文本、富文本与版式文档的区别
• 能区分编码、解码与转码，并了解 UTF-8 / GBK 乱码的成因
• 能独立下载并安装 VS Code，并切换为中文界面
• 能用「通过编码重新打开」检查乱码，而不是直接覆盖保存
• 能在编辑器中查看并切换文件编码
• 尝试使用多光标、全项目搜索和预览替换结果
• 尝试下载安装一款 JetBrains 系的 IDE，如 CLion 等，并尝试进行简单的探索与使用 （比如，搞点新花样，来个 World, Hello!）。

九、值得我们思考的问题