Currency Exchange Rates - VS Code 插件

💱 一个功能强大的 VS Code 插件，用于查看实时货币汇率并进行汇率计算。

✨ 功能特性

• 🎯 侧边栏视图：在主侧边栏添加专属货币汇率面板，一键访问
• 📊 实时汇率显示：在状态栏实时显示指定货币对的汇率
• ⬆️ 历史汇率显示：点击具体货币查看其历史汇率
• 💰 汇率计算器：支持多种货币之间的快速转换计算
• 🌐 双语切换：支持English/简体中文切换
• 🔄 自动刷新：可配置的自动刷新间隔
• 🌍 支持主要货币：包括美元、欧元、英镑、日元、人民币等18种主要货币
• ⚙️ 灵活配置：可自定义状态栏显示的货币对和刷新频率
• 🎨 美观界面：现代化的卡片式设计，支持VS Code主题

📦 支持的货币

• USD (美元) 🇺🇸
• EUR (欧元) 🇪🇺
• GBP (英镑) 🇬🇧
• JPY (日元) 🇯🇵
• CNY (人民币) 🇨🇳
• HKD (港币) 🇭🇰
• KRW (韩元) 🇰🇷
• AUD (澳元) 🇦🇺
• CAD (加元) 🇨🇦
• SGD (新加坡元) 🇸🇬
• CHF (瑞士法郎) 🇨🇭
• NZD (新西兰元) 🇳🇿
• THB (泰铢) 🇹🇭
• MYR (马来西亚林吉特) 🇲🇾
• RUB (俄罗斯卢布) 🇷🇺
• INR (印度卢比) 🇮🇳
• BRL (巴西雷亚尔) 🇧🇷
• ZAR (南非兰特) 🇿🇦

🚀 快速开始

安装方法

方法一：从VS Code插件（MarketPlace）直接安装

1. 点击侧边栏Extension按钮
2. 在搜索栏（Search Extensions in Marketplace）搜索Currency Exchange Rates
3. 找到本插件安装

方法二：从 VSIX 文件安装（推荐）

1. 下载 currency-exchange-rates-2.0.0.vsix 文件
2. 打开 VS Code
3. 按 Ctrl+Shift+P (Windows/Linux) 或 Cmd+Shift+P (Mac) 打开命令面板
4. 输入 Extensions: Install from VSIX...
5. 选择下载的 .vsix 文件
6. 重启 VS Code

方法三：使用命令行安装

code --install-extension currency-exchange-rates-2.0.0.vsix

使用方法

1. 使用侧边栏视图

安装后，在 VS Code 左侧活动栏会出现一个 💱 货币图标：

• 点击图标：打开货币汇率侧边栏
• 查看主要汇率：以卡片形式展示8种主要货币的实时汇率
• 历史汇率：点击任意货币卡片，即可查看历史汇率
• 配置选项：在侧边栏底部可以：
  • 选择状态栏显示的货币对
  • 调整刷新间隔
  • 使用汇率计算器

2. 查看状态栏汇率

安装后，插件会自动在 VS Code 底部状态栏右侧显示汇率信息。点击状态栏的汇率信息可以查看更多货币的详细汇率。

3. 查看实时汇率

• 点击状态栏的汇率信息
• 侧边栏点击“查看详细汇率”

将打开一个面板，显示所有支持货币的实时汇率。

4. 查看历史汇率

• 在侧边栏实时汇率中点击具体货币卡片可查看历史汇率
• 在详细实时汇率界面中点击具体货币行可查看历史汇率

5. 刷新汇率数据

• 在侧边栏点击"🔄 刷新"按钮，或
• 按 Ctrl+Shift+P 打开命令面板，输入 刷新汇率数据

6. 语言切换

• 侧边栏点击🌐可进行中英文切换

📝 命令列表

插件提供以下命令（可通过 Ctrl+Shift+P 访问）：

• 查看实时汇率 - 打开实时汇率查看面板
• 汇率计算器 - 打开汇率计算器
• 刷新汇率数据 - 手动刷新汇率数据

🔧 开发和构建

如果你想从源代码构建插件：

前置要求

• Node.js (>= 18.0.0)
• npm 或 yarn

构建步骤

# 1. 安装依赖
npm install

# 2. 编译 TypeScript
npm run compile

# 3. 打包成 VSIX 文件
npm run package

打包完成后，会在项目根目录生成 currency-exchange-rates-2.0.0.vsix 文件。

📊 数据来源

本插件使用多个可靠的免费汇率 API，采用智能故障转移机制确保数据可用性：

主要数据源（按优先级）

1. Frankfurter API - 首选数据源

   • 开源免费，基于欧洲央行数据
   • 无需 API 密钥
   • 高可靠性和准确性

2. ExchangeRate-API - 备用数据源

   • 免费，支持多种货币
   • 数据更新及时

3. Open Exchange Rates API - 第二备用

   • 稳定可靠的备用方案

4. Currency API - 第三备用

   • GitHub 托管，开源免费
   • CDN 加速访问

数据更新机制

• 自动刷新间隔：每 5 分钟（可配置：60-3600 秒）
• 智能缓存：减少网络请求，提升响应速度
• 故障转移：当主数据源不可用时，自动切换到备用源
• 离线缓存：网络故障时使用最后一次成功获取的数据

数据每5分钟自动更新一次（可配置）。

⚠️ 注意事项

1. 本插件提供的汇率数据仅供参考，不作为实际交易依据
2. 汇率数据来自第三方 API，可能存在延迟
3. 需要网络连接才能获取最新汇率数据
4. 首次使用时会请求网络权限

🐛 问题反馈

如果遇到问题或有功能建议，请通过以下方式反馈：

• 在 VS Code 中查看输出面板（查看 -> 输出 -> 选择 Currency Exchange Rates）
• 检查网络连接是否正常
• 确认防火墙没有阻止插件访问网络

📄 许可证

MIT License

🙏 致谢

感谢以下开源项目和服务：

• Frankfurter API
• ExchangeRate-API
• Currency API
• VS Code Extension API

👨‍💻 作者

kaifeishen

享受使用！ 如果觉得这个插件有用，请给个⭐️支持一下！