VSCode 简繁转换插件
一个简单易用的 VSCode 扩展,可以将选中的中文文本在简体与繁体之间快速转换。
功能特性
- 🚀 双向转换:支持简体转繁体和繁体转简体
- 🌐 在线转换:基于在线服务进行准确的简繁转换
- 📝 智能检测:自动检测选中文本是否包含中文字符
- ⚡ 快速响应:实时转换,无需等待
- 🎯 精确替换:直接替换选中的文本内容
- 🖱️ 右键菜单:选中文本后右键即可选择转换方向
安装方法
方法一:从 VSCode 扩展市场安装
- 打开 VSCode
- 按
Ctrl+Shift+X (Windows/Linux) 或 Cmd+Shift+X (macOS) 打开扩展面板
- 搜索 "简繁转换"
- 点击安装
方法二:本地安装
- 克隆或下载此项目
- 在项目根目录运行:
npm install
npm run compile
- 按
F5 启动调试模式,或打包为 .vsix 文件进行安装
使用方法
基本操作
- 选择文本:在 VSCode 编辑器中选中要转换的中文文本
- 右键菜单:右键点击选中的文本
- 选择转换:在右键菜单中选择:
- "convertToTraditional" - 转换为繁体中文
- "convertToSimplified" - 转换为简体中文
- 完成转换:文本将自动替换为转换后的版本
命令面板操作
- 选中文本后,可以通过命令面板 (
Ctrl+Shift+P 或 Cmd+Shift+P ) 输入:
- "convertToTraditional" - 转换为繁体中文
- "convertToSimplified" - 转换为简体中文
系统要求
- VSCode 版本:1.74.0 或更高
- Node.js 版本:16.x 或更高
- 网络连接:需要访问在线转换服务
技术实现
核心功能
- 使用 TypeScript 开发
- 基于
axios 进行 HTTP 请求
- 调用在线简繁转换服务 (fanjianhuzhuan.bmcx.com)
- 集成 VSCode 扩展 API
项目结构
vscode_chs_to_cht/
├── src/
│ └── extension.ts # 主要扩展逻辑
├── zh_hans_to_zh_hant.py # Python 参考实现
├── package.json # 项目配置
├── tsconfig.json # TypeScript 配置
└── README.md # 项目说明
开发说明
环境搭建
# 安装依赖
npm install
# 编译 TypeScript
npm run compile
# 监听文件变化
npm run watch
调试
- 按
F5 启动调试模式
- 在新窗口中测试扩展功能
- 查看控制台输出进行调试
注意事项
- ⚠️ 网络依赖:此扩展需要网络连接才能正常工作
- 🔒 隐私说明:转换的文本会发送到第三方服务进行处理
- 📊 使用限制:建议不要转换过长的文本内容
- 🛡️ 错误处理:网络异常时会显示相应的错误提示
- ⏱️ 超时设置:网络请求超时时间为10秒
故障排除
常见问题
Q: 转换失败怎么办?
A: 请检查网络连接是否正常,或稍后重试。转换服务可能有访问限制。
Q: 选中文本后没有右键菜单?
A: 确保选中的文本包含中文字符,扩展会自动检测。
Q: 扩展无法激活?
A: 检查 VSCode 版本是否满足要求(1.74.0+)。
Q: 转换结果不正确?
A: 某些特殊字符或格式可能影响转换效果,建议检查转换后的文本。
更新日志
v0.0.2
- 支持双向转换(简体转繁体、繁体转简体)
- 优化错误处理和用户提示
- 改进网络请求稳定性
v0.0.1
- 初始版本发布
- 支持基本的简繁转换功能
- 集成右键菜单操作
贡献指南
欢迎提交 Issue 和 Pull Request 来改进这个扩展!
开发贡献
- Fork 本项目
- 创建功能分支 (
git checkout -b feature/AmazingFeature )
- 提交更改 (
git commit -m 'Add some AmazingFeature' )
- 推送到分支 (
git push origin feature/AmazingFeature )
- 打开 Pull Request
许可证
本项目采用 MIT 许可证。
相关链接
如果这个扩展对您有帮助,请给个 ⭐ 支持一下!
| |