# Eclipse-Corrosion

**Repository Path**: mirrors/Eclipse-Corrosion

## Basic Information

- **Project Name**: Eclipse-Corrosion
- **Description**: Eclipse Corrosion 是 Eclipse IDE 中的 Rust 版本，本质上是一个 Eclipse IDE 的 Rust 插件，通过与 Rust 语言服务器和 Ca
- **Primary Language**: Java
- **License**: EPL-2.0
- **Default Branch**: master
- **Homepage**: https://www.oschina.net/p/eclipse-corrosion
- **GVP Project**: No

## Statistics

- **Stars**: 16
- **Forks**: 1
- **Created**: 2019-10-17
- **Last Updated**: 2025-08-30

## Categories & Tags

**Categories**: eclipse-plugins

**Tags**: None

## README

<img alt="logo" src="./images/corrosionLogo.svg" width="200px"/>

# Eclipse Corrosion
### Rust edition and debug in Eclipse IDE

Corrosion is a Rust development plugin for the Eclipse IDE, providing a rich edition experience through integration with the Rust Analyzer language server, Cargo runner and gdb debugger.

## Download/Install

### Corrosion

Download a fully-fledged Eclipse IDE for Rust development from [Corrosion download area](https://download.eclipse.org/corrosion/snapshots/products/).

*OR*

With Eclipse IDE properly installed on your machine, just click [Here](https://mickaelistria.github.io/redirctToEclipseIDECloneCommand/redirectToMarketplace.html?entryId=3835145)

*OR*

From a working Eclipse IDE, find [Eclipse Corrosion](https://marketplace.eclipse.org/content/eclipse-corrosion) on the Eclipse Marketplace ([how to install from marketplace](https://marketplace.eclipse.org/marketplace-client-intro?mpc_install=3835145))

*OR*

From a working Eclipse IDE, install from p2 repository [https://download.eclipse.org/corrosion/snapshots/](https://download.eclipse.org/corrosion/snapshots/).

### Uses Rust Toolchain

To install the Rust toolchain, consider visiting <https://rustup.rs/> and install Rustup.  
On Linux and MacOS, the toolchain can also be installed via Corrosion in the `Rust` preference page (`Window > Preferences`).

## Features

Corrosion brings together multiple different sources of features to make an enjoyable developing environment. Here are just a few of the most common features. Download today to discover all Corrosion has to offer.

### Rust Language Server
Rust Analyzer supplies Corrosion with the majority of the edition abilities. More information can be found at the [Rust-Analyzer GitHub Repository](https://github.com/rust-analyzer/rust-analyzer).
 - Completion Assist
 - Documentation Hover
 - Diagnostics
 - Formatting

![RLS features](images/rls-features.gif)

### Debug
Using the `rust-gdb`, Corrosion enables users to debug their Rust programs with intelligent supports.
 - Variables View
 - GDB Console
 - Breakpoints
 - Expression Execution

![Debug features](images/debug-features.gif)

### Cargo Test monitoring

Corrosion brings a `Unit Tests` view to monitor progress of your test executions, and easily analyze test reports.

<img alt="logo" src="./images/testReports.png" width="600px"/>

See also [▶️video demo](https://www.screencast.com/t/1sgBo0ENGc).

### Cargo and Rustup Integration

Corrosion is built for all Rust developers, newcomers to experts, bringing a GUI to common Cargo features.
 - New Project Wizard
 - Toolchain Management
 - TOML file editing support
 - Export Crate Wizard

![Cargo and Rustup features](images/cargo-features.gif)


### in the powerful in versatile Eclipse IDE

Corrosion fits right into the standard Eclipse IDE workflows that boost productivity:
 - Project Outline
 - Dark Theme
 - Problems View
 - Git integration (Only available in Corrosion Package)
 - Embedded Terminal (Only available in Corrosion Package)
 - ...all Eclipse Marketplace extensions you like, including support for any other language!

![Eclipse features](images/eclipse-features.gif)

## Contributing

<a href="https://mickaelistria.github.io/redirctToEclipseIDECloneCommand/redirect.html"><img src="https://mickaelistria.github.io/redirctToEclipseIDECloneCommand/cloneToEclipseBadge.png" alt="Clone to Eclipse IDE"/></a>

Corrosion is always open to new features and pull requests. If you have a feature or bug you wish to work on, [file an issue](https://github.com/eclipse/corrosion/issues) and other Corrosion developers will be able to help you get started.

Refer to our [Contributing Guide](CONTRIBUTING.md) for more instructions.

### Project Overview

For the **edition**, Corrosion uses the [lsp4e](https://projects.eclipse.org/projects/technology.lsp4e) project to integrate with the [Rust Analyzer](https://github.com/rust-analyzer/rust-analyzer) and [TM4E](https://projects.eclipse.org/projects/technology.tm4e) project to provide syntax highlighting in order to provide a rich Rust editor in the Eclipse IDE.

`rustup` is used to easily provisin the various necessary Rust tools.

**Initialization, import and export** of projects and execution are provided by integration with `cargo` command.

**Debugging** is provided by integration with `rust-gdb` and Eclipse CDT GDB support.

 > Corrosion was formerly called RedOx, but required a name change due to naming overlap with another project ([See issue #24](https://github.com/eclipse/corrosion/issues/24))

### License

Corrosion is an open-source project licensed under [The Eclipse Public License - v 2.0](https://www.eclipse.org/legal/epl-2.0/)

The Rust and Cargo logos are owned by Mozilla and distributed under the terms of the [Creative Commons Attribution license (CC-BY)](https://creativecommons.org/licenses/by/4.0/) ([More Info](https://www.rust-lang.org/en-US/legal.html)).

[More Licensing Information](NOTICE.md)