---
description: 编辑器与文件格式约定，换行符与编码规范
alwaysApply: true
---

# 编辑器与文件格式约定

## 开发环境

当前开发机器环境为 **Windows**，所有**新建文件**默认使用 **CRLF** 换行符。

## 已有文件：禁止修改格式

编辑已有文件时，**必须保持原文件的换行符与编码格式不变**：

- **不要**将 LF 改为 CRLF，或 CRLF 改为 LF
- **不要**转换文件编码（如 GBK → UTF-8、UTF-8 → UTF-8 BOM 等）
- 遵循文件本来的换行符和编码格式进行编辑

若检测到已有文件的编码为非 UTF-8 或非 UTF-8 BOM，在输出中**提示用户**即可，**不要**自动转换。

## 新建文件

新建文件时的编码优先级：

1. **UTF-8 BOM**（首选）
2. **UTF-8**（次选）

换行符：**CRLF**。