# vscode插件-中文符号替换

**Repository Path**: zheng_yongtao/vscode-plugin-ChineseSymbolReplace

## Basic Information

- **Project Name**: vscode插件-中文符号替换
- **Description**: 一个vs code插件，可以在编写代码的时候将中文符号自动替换成英文符号
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-18
- **Last Updated**: 2025-10-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Chinese Punctuation Replacer

一个VSCode插件，可以自动将中文标点符号替换为英文标点符号，提高代码编写的效率。

## 功能特性

- 🔄 **实时替换**: 在输入时自动将中文标点符号替换为英文标点符号
- 📋 **粘贴替换**: 粘贴内容时自动替换其中的中文标点符号
- ⚙️ **灵活配置**: 可以启用/禁用功能，自定义替换行为
- 🎯 **精确映射**: 支持常用的中文标点符号到英文标点符号的映射
- 🚀 **智能延迟**: 使用延迟机制避免干扰VSCode的代码补全功能
- 💻 **代码文件保护**: 默认不在代码文件中进行替换，避免影响开发体验

## 支持的标点符号映射

| 中文标点符号 | 英文标点符号 | 说明 |
|------------|-------------|------|
| ， | , | 逗号 |
| 。 | . | 句号 |
| ； | ; | 分号 |
| ： | : | 冒号 |
| ？ | ? | 问号 |
| ！ | ! | 感叹号 |
| " " | " " | 双引号 |
| ' ' | ' ' | 单引号 |
| （ ） | ( ) | 括号 |
| 【 】 | [ ] | 方括号 |
| ｛ ｝ | { } | 花括号 |
| ～ | ~ | 波浪号 |
| — | - | 破折号 |
| … | ... | 省略号 |
| 《 》 | < > | 书名号 |

## 安装和使用

### 安装

1. 克隆或下载此项目
2. 在项目目录中运行 `npm install`
3. 运行 `npm run compile` 编译TypeScript代码
4. 在VSCode中按 `F5` 启动调试模式，或打包为 `.vsix` 文件进行安装

### 使用

插件安装后会自动激活，你可以：

1. **直接输入**: 在编辑器中输入中文标点符号，插件会自动替换为英文标点符号
2. **粘贴内容**: 粘贴包含中文标点符号的文本时，插件会自动替换
3. **手动控制**: 使用命令面板（Ctrl+Shift+P）搜索以下命令：
   - `启用中文标点符号替换`
   - `禁用中文标点符号替换`

## 配置选项

在VSCode设置中可以配置以下选项：

- `chinesePunctuationReplacer.enabled`: 是否启用插件（默认：true）
- `chinesePunctuationReplacer.replaceOnType`: 是否在输入时实时替换（默认：true）
- `chinesePunctuationReplacer.replaceOnPaste`: 是否在粘贴时替换（默认：true）
- `chinesePunctuationReplacer.replaceInCodeFiles`: 是否在代码文件中进行替换（默认：false，避免干扰代码补全）
- `chinesePunctuationReplacer.delayMs`: 替换延迟时间（默认：300ms，用于避免干扰代码补全）

## 开发

### 项目结构

```
├── src/
│   ├── extension.ts          # 主插件逻辑
│   └── punctuationMap.ts     # 标点符号映射表
├── package.json              # 插件配置
├── tsconfig.json             # TypeScript配置
└── README.md                 # 说明文档
```

### 开发命令

```bash
# 安装依赖
npm install

# 编译TypeScript
npm run compile

# 监听文件变化并自动编译
npm run watch
```

### 调试

1. 在VSCode中打开项目
2. 按 `F5` 启动调试模式
3. 在新窗口中测试插件功能

## 贡献

欢迎提交Issue和Pull Request来改进这个插件！

## 常见问题

### Q: 为什么输入中文句号后，Math. 不会弹出代码补全？

A: 插件会自动触发代码补全。如果代码补全没有弹出，请确保：
1. 在设置中启用 `chinesePunctuationReplacer.replaceInCodeFiles`
2. 确保在代码文件中使用插件

### Q: 如何调整替换的延迟时间？

A: 在VSCode设置中搜索 "chinesePunctuationReplacer.delayMs"，调整延迟时间（默认100ms）。

## 许可证

MIT License