Installation ZH

安装

🌍 English · Polski · Français · Deutsch · 中文

ECLI 为 Linux、FreeBSD、macOS 和 Windows 提供原生包,以及跨平台的 PyPI 分发版。选择适合您环境的方式。

选择安装方法

方法	最适合	备注
原生包(.deb/.rpm/.pkg/.dmg/.exe)	生产环境,系统级安装	单一二进制文件,无需 Python
PyPI(pip install ecli-editor)	Python 开发者,virtualenv,CI	需要 Python 3.11+ 和系统依赖
从源码	贡献者,自定义构建	参见 build-from-source.md

所有制品在 Releases 页面。每个二进制文件都有 .sha256 用于验证。

---

Linux

Debian / Ubuntu

wget https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_linux_x86_64.deb
wget https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_linux_x86_64.deb.sha256

sha256sum -c ecli_0.1.3_linux_x86_64.deb.sha256

sudo apt install ./ecli_0.1.3_linux_x86_64.deb

Fedora / RHEL / Rocky / CentOS Stream

wget https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_linux_x86_64.rpm
sudo dnf install ./ecli_0.1.3_linux_x86_64.rpm

Arch Linux / Manjaro

暂无 AUR 包。使用 tarball:

wget https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_linux_x86_64.tar.gz
tar -xzf ecli_0.1.3_linux_x86_64.tar.gz
sudo mv ecli /usr/local/bin/

必需的系统库

# Debian / Ubuntu
sudo apt install libncursesw6 libtinfo6

# Fedora / RHEL
sudo dnf install ncurses

# Arch
sudo pacman -S ncurses

---

FreeBSD

fetch https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_freebsd_x86_64.pkg
sudo pkg add ./ecli_0.1.3_freebsd_x86_64.pkg

FreeBSD 上的 ECLI 需要 ncurses 和 libyaml(通过包依赖自动安装)。

---

macOS

ECLI 以 Universal2 DMG 形式提供,经过临时签名(未公证)。首次启动需要手动批准。

curl -LO https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_macos_universal2.dmg
open ecli_0.1.3_macos_universal2.dmg
cp /Volumes/ECLI/ecli /usr/local/bin/

首次启动将被 Gatekeeper 阻止。 两个选项:

选项 A(GUI):

• 系统设置 → 隐私与安全性
• 滚动到底部 — 会看到 "ecli was blocked"
• 点击 "Open Anyway"

选项 B(CLI):

xattr -d com.apple.quarantine /usr/local/bin/ecli

完整说明:docs/install/macos.md。

---

Windows

提供两种制品:

安装程序(推荐)

curl.exe -LO https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_win_x86_64_setup.exe
.\ecli_0.1.3_win_x86_64_setup.exe

安装程序将 ECLI 注册到"程序和功能",添加到 PATH,并创建开始菜单快捷方式。

便携版

curl.exe -LO https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_win_x86_64.exe
.\ecli_0.1.3_win_x86_64.exe README.md

无需安装 — 从任何目录运行。

Windows SmartScreen 在首次启动时会警告(未签名的可执行文件)。点击 "更多信息" → "仍要运行"。

完整说明:docs/install/windows.md。

---

PyPI(任何平台)

需要 Python 3.11 或更新版本。

# 系统级(在托管系统上不推荐)
pip install ecli-editor

# 用户安装
pip install --user ecli-editor

# 在 virtualenv 中(推荐)
python3 -m venv ~/.venv/ecli
source ~/.venv/ecli/bin/activate
pip install ecli-editor

验证:

ecli --version

仍需要系统依赖(终端库)— 参见上面针对发行版的命令。

---

校验和验证

每个发布制品都有 .sha256 文件。安装前验证:

# Linux / macOS / FreeBSD
sha256sum -c ecli_0.1.3_linux_x86_64.deb.sha256

# Windows PowerShell
Get-FileHash -Algorithm SHA256 ecli_0.1.3_win_x86_64_setup.exe
# 手动与 .sha256 文件内容比较

---

卸载

平台	命令
Debian / Ubuntu	sudo apt remove ecli
Fedora / RHEL	sudo dnf remove ecli
FreeBSD	sudo pkg remove ecli
macOS	删除 /usr/local/bin/ecli 或从 /Applications 拖到废纸篓
Windows	程序和功能 → ECLI → 卸载
PyPI	pip uninstall ecli-editor

配置保留在 ~/.config/ecli/(Linux/FreeBSD)、~/Library/Application Support/ecli/(macOS)或 %APPDATA%\ecli\(Windows)。如需要请手动删除。

---

故障排查

参见 故障排查:

• "ecli: command not found"
• "Library not loaded"(macOS)
• "VCRUNTIME140.dll missing"(Windows)
• 权限错误
• Locale 和 UTF-8 问题