AI Translate 是一款基于LLM实现的IDE专用翻译插件，主要为开发人员在查看项目源码时，可以快速对一些代码英文注释进行中文翻译，这对于英文有些弱的同学很有帮助，下面讲一下为什么开发这款IDE插件，以及它比其它同类翻译插件有什么好处。 为什么开发这款翻译插件 在以前使用IDE看项目源码时，经常遇到长段的英文段落注释信息，理解起来经常会吃力。当时找了一些翻译插件，但都感觉多多少少有些缺陷。 主要表现以下几点： 翻译质量差，有些翻译软件可能将一些专业术语翻译成了其它名词，整体翻译后的语句读起来很让人头疼 由于在源码文件里，多数源码说明 信息都是以注释方式出现的，多数翻译软件无法做到忽略注释符后连贯起来翻译。 目前市面比较好用的翻译插件“沉浸式翻译”，可惜只支持浏览器，并不支持IDE 曾有一段时间的做法是手动从IDE里复制信息、删除注释符、重新整理段落，再到网页翻译里进行翻译，有时翻译的效果不太好，可能同时会用两个翻译软件。 去年看kubernets源码时，再次被折腾一番，当时花了两三个小时开发了一款基于chrome浏览器的插件，主要实现功能是在软件翻译前，将注释符移除和重新整理段落，这样效果稍微好一些，毕竟节省了不少时间，只是仍未解决从IDE复制代码再进行翻译的问题。 前段时间看ETCD源码时，再次被这个折腾一番，最终还是决定开发一款IDE翻译插件，正好可以使用LLM来解决以前传统翻译软件翻译质量不太好的问题。主要改进两点，一个是有一些专业术语被翻译成了普通的单词，读起来很无语；另一个是有些单词没有必要翻译成中文，保持原样即可，但翻译软件硬是翻译成了中文。 调研了几款目前市面上流行的插件，好像都不支持IDE的这种翻译功能。 沉浸式阅读插件功能十分强大，即可以使用传统翻译软件，也可以使用LLM进行翻译，只可惜的是当前只有浏览器插件，并不支持IDE的翻译功能。 Alibaba的“通义灵码”IDE插件，功能也十分强大，在IDE工具里直接集成LLM，实现用户交互，可惜的只竟然不支持翻译功能 既然没有轮子，那就造一个吧，插件开发也挺简单的，也花不了太多的时间。 JetBrains IDE 插件开发太麻烦了，每次都等于开启两个窗口，内存和CPU几乎吃完了，调试一次运气不好的话，花1个小时也正常，相对来说vscode 插件开发就容易的多了。 实现原理 插件的功能很简单，只做一件事：将用户在IDE里选择的文本信息发送到LLM提供的API接口，然后再将接口返回的信息在IDE控制终端输出。 至于这个翻译功能主要是在LLM应用端通过配置 prompt 来实现的，告诉LLM你是一个技术开发人员，熟练各种开发语言，将收到的信息整理后，翻译中文并输出就可以了。 在LLM端可以配置多种功能，如是否启用“记忆”功能和一些插件，以实现更多的功能。 插件功能 因此可以自定义prompt实现类似的功能，如 程序员变量命名、SQL解释、代码解释等。 如果IDE插件“通义灵码”有翻译功能，则完全满足当前需求了，遗憾就是没有这个翻译功能，这也正是开发这个插件的原因。 支持哪些IDE 目前主要支持 VSCode 编辑器和 JetBrains 公司的IDE产品。 VSCode：https://marketplace.visualstudio.com/items?itemName=cfanbo.ai-translate (GitHub) JetBrains Marketplace: https://plugins.jetbrains.com/plugin/25313-ai-translate (GitHub) 使用教程 使用插件前，需要填写通义千问应用的 APPID 和 APPKEY，如果还没有开通的话，需要开通后(https://bailian.aliyun.com/)，创建应用后可获取这两项信息。 使用方法很简单，共两步： 在 IDE 里选择要翻译的内容，一般指注释信息 右键选择“AI 翻译“ 菜单即可，也可以使用快捷键 Ctrl+Alt+T 如果使用的是 JetBrains 系统IDE的话，注意快捷键是否有冲突，可以自行设置快捷键。

今年又一次重新学习RUST这门编程语言，并从零开发了一个kv存储系统 minKV，慢慢的越来越有感觉了。 本篇主要将日常学习中收集的一些入门教程进行一下汇总，希望对于一些想学习这门开发语言的同学有所帮助。 下面教程按照推荐顺序，由浅到深依次列出。以下内容将不定期的更新，请自行收藏。 如果您有更多好的教程的话，也可以在评论区列出，大家相互学习。 入门教程 Rust 程序设计语言 https://doc.rust-lang.org/book/ / (中文版) 官方教程，强烈推荐，同时还有非官方翻译的中文版。遗憾的是这个教程有许多概念介绍的都有点不清不楚，只能通过下方的一些资料自行补习。 https://play.rust-lang.org/ 在线 RUST 程序 Playground，类似golang的 Playground，非常的方便 Rust Language Cheat Sheet 看完官方的教程后，紧接着就看这篇，先了解一些内存布局，后面再看其它教程就更容易理解了 The Cargo Book Cargo 是RUST 中的包管理工具，开发必备工具 https://rust-lang-nursery.github.io/rust-cookbook/ / (Rust Cookbook 中文版) Rust语言圣经(Rust Course) rust-by-example 在实践中学 Rust Rust By Practice Rust语言实战 / (中文版) 100 Exercises To Learn Rust Comprehensive Rust 由Google 的 Android 团队开发的免费 Rust 课程 Tour of Rust 进阶教程 Tokio 异步运行时 强烈推荐 ！！！一个强大的运行时，目前市场占有绝对的优势，每个RUST必学 Command Line Applications in Rust 开发命令行工具必具。有一个 clap 的crate，它有 Builder 和 Derive 两种用法，本人在开发 gitig 和 minkv 两个项目时分别使用到了这两种用法，推荐使用 Derive 用法，比较简单易理解 The Rustonomicon Rust 宏小册 Rust and WebAssembly WASM开发手册 深入RUST标准库 国内同学翻译的，不过是两年前翻译的，可能与现在使用的标准库有些差别，不过作为阅读标准库的参考书也不错 开发规范 Rust API Guidelines PingCAP Style Guide 视频教程 如果习惯看视频学习的话，可以看以下列出的一些B站UP主视频，前两个UP主的视频与一些教程是同步的，以视频的形式重新对教程进行了讲解。

上一篇 我们介绍了一些错误处理的最基本的用法，主要是指对 panic! 、unwrap、expect 和 ? 这些宏或函数的介绍。但这仅仅是一些最基本的处理方法，对于自定义错误这一块并没有做任何介绍。 实际开发中可能默认的错误类型，并无法满足我们的业务需求，这时一般需要通过定义自己的错误类型来实现。在rust中错误类型是通过 enum 枚举定义的，对此官方文档也做了一些简介，本文主要介绍一些业务开发过程中对错误的处理方案，当然主要是一些最基本的用法。 自定义 Error 在 Rust 中，自定义错误类型是一种常见的类型，特别是当你需要提供比标准错误类型更具体的错误信息时。Rust 中的错误处理是通过 Result 和 Error trait 来实现的。以下是如何实现一个自定义错误的示例： 定义一个错误枚举类型。 实现 std::fmt::Display 为自定义错误提供用户友好的错误信息。 实现 std::error::Error trait，这通常是通过派生 Error trait 来完成的。 下面是一个简单的示例： use std::fmt; use std::error::Error; // 定义一个自定义错误枚举 #[derive(Debug)] enum MyError { Io(std::io::Error), // 包装标准库的I/O错误 NotFound(String), // 一个未找到的错误，包含一个描述信息 InvalidInput(String), // 无效输入错误，包含一个描述信息 } // 为自定义错误实现 Display trait impl fmt::Display for MyError { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { match *self { MyError::Io(ref err) => write!

gitig 是一款基于 https://github.com/github/gitgnore 仓库开发的.gitignore 客户端CLI 管理工具，也是每个开发者必不可少的提高工作效率的必具工具。 它基于官方仓库 https://github.com/github/gitgnore 丰富的 .gitignore 数据源，帮助开发者快速实现添加各类开发项目的git版本控制忽略文件清单。 开发背景 工作中，经常需要开发各类项目，如基于 vscode 编写 rust 项目，这时为了方便进行Git管理控制，有些项目文件可能并不需要提交到git仓库，需要将一些文件写入 .gitignore 文件进行忽略。 如果手动编辑 .gitignore文件可能有些麻烦，另外也能会有一些文件项被遗忘或写错，这时如果有一些工具可以将行业能用的忽略配置项一键写入 .gitignore 文件似乎是一个不错的主意。 其中著名的 https://github.com/github/gitignore 就是一个专门收集各类开发语句或IDE 需要忽略的 .gitignore 推荐配置的仓库，目前star 已高达 160K，它也是由 GitHub 官方旗下的一个仓库，目前仍在更新。 官方对它的介绍 This is GitHub’s collection of .gitignore file templates. We use this list to populate the .gitignore template choosers available in the GitHub.com interface when creating new repositories and files. 可以看下收集的各种开发语言或ide 推荐忽略文件 gitig就是一款专用解决这个问题的工具，软件安装后自动包含数据源信息，后期随着数据源仓库的更新也会更新发布新版本，它不需要联网支持直接离线操作，只有不到 2M 大小。 功能介绍 对于它的安装方法也很简单，可以参考 https://github.

Rust 中错误可分为两大类：可恢复的（recoverable）和 不可恢复的（unrecoverable）错误。 对于一个可恢复的错误，比如文件未找到或权限不足的错误，我们很可能只想向用户报告问题，让用户来决定后续操作。 不可恢复的错误总是 bug 出现的征兆，比如试图访问一个超过数组末端的位置，因此我们要立即停止程序，主要通过 panic! 实现。 panic! panic!属于不可恢复错误类型，一旦发生程序将立即退出。 fn main() { panic!("crash and burn"); } 这里由用户调用 panic! 宏来实现程序的中止，同时自定义错误信息。 ➜ cargo run Compiling hello-world v0.1.0 (/Users/sxf/workspace/rust/hello-world) Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.68s Running `target/debug/hello-world` thread 'main' panicked at src/main.rs:2:5: crash and burn note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace 切记：一旦调用 panic! ，程序将立即中止运行，且无法恢复。 至于什么时候使用 panic! ，可参考文档：要不要 panic! 系统默认错误 unwrap unwrap 底层调用的 panic!，因此也属于不可恢复错误。 调用 unwrap() 获取 Result 中 Ok(value) 的value，如果 Result 的值为 Err，则直接 panic!