Skip to content

Geekstrange/enhanced-ls

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

enhanced-ls

这是一个跨平台的增强版“ls” 命令工具,旨在为用户提供更丰富、更便捷的文件和文件夹列表查看体验

功能特点

  • 🎨 彩色输出:目录、可执行文件和符号链接使用不同颜色显示
  • 📝 文件类型指示符:在文件名后添加 /(目录)、*(可执行文件)或 @(符号链接)
  • 📊 多列布局:自动适应终端宽度进行多列显示
  • 🖥️ 详细模式:使用 -l 选项显示表格布局
  • 📏 CJK字符支持:正确处理中文、日文、韩文字符的宽度计算
  • 🚀 轻量高效:Golang实现,无需外部依赖

环境要求

  1. 建议使用PowerShell 7.2+
  2. 建议使用Windows Terminal / Tabby / Fluent Terminal 等现代终端

安装

  1. 将项目克隆或下载到本地:

    git clone https://github.com/Geekstrange/enhanced-ls.git
  2. 在 PowerShell 配置文件 ($PROFILE) 中添加以下内容:

    # 移除现有的 ls 别名
    Remove-Item Alias:ls -ErrorAction SilentlyContinue
    
    # 设置 ls 别名指向enls.exe
    function Invoke-Ls {
        \path\to\enls.exe -c @args  # @args 表示透传所有参数
    }
    Set-Alias ls Invoke-Ls
  3. 重新加载配置文件:

    .$PROFILE

使用说明

使用Windows下的PowerShell 7.5+演示

基本命令

ls [路径] [选项]

选项

选项 描述
-f-F 显示文件类型指示符(*/@#~%) 筛选指定类型文件(如-f "#"仅显示压缩文件)
-c-C 启用彩色输出
-l-L 详细列表模式
-s 忽略大小写查询
-S 严格匹配大小写查询
-r 递归显示
--help 显示帮助信息

示例

  1. 基本使用(多列布局,自动适应终端宽度):

    ls

    ls

  2. 彩色输出

    ls -c

    ls-c

  3. 显示文件类型指示符

    ls -f

    ls-f

  4. 组合选项(彩色+文件类型+表格指示符):

    ls -c -f -l或ls -cfl

    ls-cfl

  5. 指定路径

    ls C:\Users
    ls -l D:\Projects
  6. 递归显示

    ls -s "r"

    ls-r

  7. 严格匹配大小写查询

    ls -S "R" -l

    ls-S-l

版本选择指南

根据您的操作系统和架构,请选择对应的安装文件以下是不同平台的版本对应关系:

操作系统 架构 文件名
Windows x86_64/AMD64 enls-vx.x.x-windows_amd64.exe
ARM64/AArch64 enls-vx.x.x-windows_arm64.exe
Linux x86_64/AMD64 enls-vx.x.x-linux_amd64
ARM64/AArch64 enls-vx.x.x-linux_arm64
LoongArch enls-vx.x.x-linux_loong64
macOS Intel (x86_64/AMD64) enls-vx.x.x-darwin_amd64
Apple Silicon (ARM64/AArch64) enls-vx.x.x-darwin_arm64

如何确定我的系统架构

Windows 系统

  1. 打开命令提示符:可以通过在开始菜单中搜索“cmd”或“命令提示符”来打开

  2. 输入命令:在命令提示符中输入以下命令并按回车键:

    wmic os get osarchitecture
  3. 查看输出结果

    • 如果显示“64-bit”,则您的系统是 64位 (x86_64)
    • 如果显示“ARM64”,则您的系统是 ARM64

Linux 系统

  1. 打开终端:可以通过在应用程序菜单中搜索“终端”或使用快捷键(通常是Ctrl+Alt+T)来打开

  2. 输入命令:在终端中输入以下命令并按回车键:

    uname -m
  3. 查看输出结果

    • 如果显示x86_64,则您的系统是 64位 (x86_64)
    • 如果显示aarch64,则您的系统是 ARM64

macOS 系统

  1. 打开终端:可以通过在应用程序菜单中搜索“终端”来打开

  2. 输入命令:在终端中输入以下命令并按回车键:

    uname -m
  3. 查看输出结果

    • 如果显示x86_64,则您的系统是 Intel (x86_64)
    • 如果显示arm64,则您的系统是 Apple Silicon (ARM64)

许可证

本项目采用 MIT 许可证


About

Making ls Smarter, Flag by Flag.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages