PureBasic UTF-8 BOM 扩展

这个 VSCode 扩展可以自动将 PureBasic 文件（.pb 和 .pbi）保存为 UTF-8-BOM 格式，确保中文字符能够正确显示和处理。

功能特点

• 自动检测 .pb 和 .pbi 文件
• 在保存时自动添加 UTF-8 BOM 头
• 可通过配置项控制自动转换行为
• 支持 PureBasic 语法高亮

安装

1. 下载扩展包 (.vsix 文件)
2. 在 VSCode 中按 Ctrl+Shift+P 打开命令面板
3. 输入并选择 "Extensions: Install from VSIX..."
4. 选择下载的 .vsix 文件进行安装
5. 重启 VSCode 完成安装

配置

扩展提供以下配置选项：

1. 自动转换设置

• 配置项: purebasicUtf8Bom.autoConvertOnSave
• 默认值: true
• 说明: 控制是否在保存时自动转换为 UTF-8-BOM 格式

2. 文件扩展名设置

• 配置项: purebasicUtf8Bom.fileExtensions
• 默认值: [".pb", ".pbi"]
• 说明: 指定需要自动添加 UTF-8 BOM 头的文件扩展名列表（包含点号）

2. 如何访问配置

您可以通过以下任一方式访问和修改配置：

方法一：通过设置界面

1. 在 VSCode 中点击左下角的齿轮图标（设置）
2. 选择"设置"
3. 在搜索框中输入 "PureBasic"
4. 找到 "PureBasic UTF-8 BOM" 配置项
5. 修改 "保存时自动转换为UTF-8-BOM格式" 选项

方法二：通过命令面板

1. 按 Ctrl+Shift+P 打开命令面板
2. 输入 "首选项: 打开设置"
3. 在设置页面搜索 "PureBasic"
4. 修改相关配置项

方法三：通过 settings.json 文件

1. 按 Ctrl+, 打开设置
2. 点击右上角的 "打开设置(JSON)" 图标
3. 添加或修改以下配置：

   {
     "purebasicUtf8Bom.autoConvertOnSave": true,
     "purebasicUtf8Bom.fileExtensions": [".pb", ".pbi"]
   }
   

使用说明

安装扩展后，所有 .pb 和 .pbi 文件在保存时都会自动添加 UTF-8 BOM 头，无需额外操作。

如果您禁用了自动转换功能，可以通过以下方式手动转换：

1. 打开需要转换的 .pb 或 .pbi 文件
2. 按 Ctrl+Shift+P 打开命令面板
3. 输入 "PureBasic" 查找相关命令（如果扩展提供了手动转换命令）

故障排除

1. 文件未自动转换

• 检查文件扩展名是否在配置的 purebasicUtf8Bom.fileExtensions 列表中
• 确认配置项 purebasicUtf8Bom.autoConvertOnSave 是否设置为 true
• 重启 VSCode 后再次尝试

2. 中文字符仍然显示异常

• 确认文件确实已添加 BOM 头（可以用十六进制编辑器查看文件开头是否为 EF BB BF）
• 检查 VSCode 的编码设置是否为 UTF-8

技术细节

• 该扩展在文件保存前拦截保存事件
• 检查文件是否已有 BOM 头，避免重复添加
• 使用 Node.js 的 fs 模块直接写入文件以确保 BOM 头正确添加

作者

xiaobantouzhuan

许可证

MIT