powershell@文件大小排序@文件夹磁盘占用分析

abstract

在powershell中完成以下任的参考方案

• 统计目录或文件的大小,文件或目录占用大小数值支持单位指定,格式友好
• 对指定目录以友好的格式列出所有文件和子目录的大小

powershell对于列出子目录大小的支持状况

列出子目录大小是一个常见的需求，而 PowerShell 的 ls 命令（或 Get-ChildItem cmdlet）默认没有直接提供这个功能，这可能有几个原因：

1. 性能考虑：
   计算子目录大小需要递归遍历所有子目录和文件，这对于大型目录结构可能会很耗时。
2. 设计哲学：
   PowerShell 遵循"做一件事并把它做好"的 Unix 哲学。Get-ChildItem 的主要功能是列出项目，而不是计算大小。
3. 灵活性：
   PowerShell 提供了构建块（如 Get-ChildItem、Measure-Object），让用户可以根据需求组合这些命令。
4. 兼容性：
   保持与 CMD 的 dir 命令和 Unix-like 系统的 ls 命令的基本行为一致。

幸运的是,powershell的ls命令提供了-Recurse 参数，可以用来递归列出所有子项目。

虽然这不直接计算子目录大小，但为实现这一功能提供了基础。基于此选项,我们可以列出指定目录下所有文件,然后针对他们的length字段统计或排列满足我们的需要

按文件大小排序指定目录下所有文件

完成这个任务对于powershell来说十分简单

例如,对当前目录执行文件大小排序操作

ls -Path .  -Recurse -File  |sort Length -Descending|select Name,Length, DirectoryName

# [cxxu@CXXUCOLORFUL][<W:192.168.1.178>][C:\repos\c_cpp_consoleapps\cpp\archives]
PS> ls -Path . -Recurse -File  |sort Length -Descending|select Name,LengthName                                                       Length
----                                                       ------
.DS_Store                                                   15364
.DS_Store                                                    6148
.DS_Store                                                    6148
.DS_Store                                                    6148
binary_tree.cpp                                              5449
18.2.3可变长数组类模板.cpp                                   	4805
longest common word.cpp                                      4289

虽然这完成了排序任务,并且可以灵活指定过滤的属性,但是Length终究不太直观,不显示单位

扩展的专用函数介绍

针对此类文件大小排列相关任务,编写扩展的函数

统计目录或文件的大小👺

• 以下函数专门为此类任务设计,并且支持指定显示格式,文件大小单位

function Get-Size
{<#.SYNOPSIS计算指定文件或目录的大小。.DESCRIPTION此函数计算指定路径的文件或目录的大小。对于目录，它会递归计算所有子目录和文件的总大小。函数支持以不同的单位（如 B、KB、MB、GB、TB）显示结果。.PARAMETER Path要计算大小的文件或目录的路径。可以是相对路径或绝对路径。.PARAMETER Unit指定结果显示的单位。可选值为 B（字节）、KB、MB、GB、TB。默认为 MB。.EXAMPLEGet-Size -Path "C:\Users\Username\Documents"计算 Documents 文件夹的大小，并以默认单位（MB）显示结果。.EXAMPLEGet-Size -Path "C:\large_file.zip" -Unit GB计算 large_file.zip 文件的大小，并以 GB 为单位显示结果。.EXAMPLE"C:\Users\Username\Downloads", "C:\Program Files" | Get-Size -Unit MB计算多个路径的大小，并以 MB 为单位显示结果。.EXAMPLE指定显示单位为KB ,显示5位小数PS> Get-Size -PrecisionFormatTable -Precision 5 -Unit KBMode  BaseName Size      Unit----  -------- ----      ----da--- PS       563.93848 KB.EXAMPLE保留3位小数(但是显示位数保持默认的2位),使用管道符`|fl`来查看三位小数PS> Get-Size -Precision 3 -Unit KBMode  BaseName   Size Unit----  --------   ---- ----da--- PS       564.14 KB.EXAMPLEPS> Get-Size -Precision 3 -Unit KB|flMode     : da---BaseName : PSSize     : 564.408Unit     : KB.EXAMPLE指定显示精度为4为小数(由于这里恰好第3,4位小数为0,所以没有显示出来,指定更多位数,可以显示)PS🌙[BAT:79%][MEM:44.52% (14.12/31.71)GB][0:03:01]# [cxxu@CXXUCOLORFUL][<W:192.168.1.178>][C:\repos\scripts\PS]PS> Get-Size -PrecisionFormatTable -Precision 4Mode  BaseName Size Unit----  -------- ---- ----da--- PS       0.55 MB指定显示精度为5为小数PS🌙[BAT:79%][MEM:44.55% (14.13/31.71)GB][0:03:05]# [cxxu@CXXUCOLORFUL][<W:192.168.1.178>][C:\repos\scripts\PS]PS> Get-Size -PrecisionFormatTable -Precision 5Mode  BaseName Size    Unit----  -------- ----    ----da--- PS       0.55002 MB.INPUTSSystem.String[]你可以通过管道传入一个或多个字符串路径。.OUTPUTSPSCustomObject返回一个包含路径、大小和单位的自定义对象。#>[CmdletBinding()]param([Parameter( ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)][string[]]$Path = '.',# [switch]$ItemType,[Parameter(Mandatory = $false)][ValidateSet('B', 'KB', 'MB', 'GB', 'TB')][string]$Unit = 'MB',#文件大小精度$Precision = 2,[switch]$PrecisionFormatTable,[switch]$Detail,[switch]$FormatTable)begin{if ($VerbosePreference){$PSBoundParameters | Format-Table  }$unitMultiplier = @{'B'  = 1'KB' = 1KB'MB' = 1MB'GB' = 1GB'TB' = 1TB}}process{foreach ($item in $Path){if (Test-Path -Path $item){$size = 0# 利用Get-item 判断$Path是文件还是目录,如果是目录,则调用ls -Recurse找到所有文件(包括子目录),然后利用管道符传递给Measure计算该子目录的大小$itemInfo = (Get-Item $item)$baseName = $itemInfo.BaseName$Mode = $itemInfo.Mode# $ItemType = $itemInfo.GetType().Nameif ($itemInfo -is [System.IO.FileInfo]){$ItemType = 'File'}elseif ($itemInfo -is [System.IO.DirectoryInfo]){$ItemType = 'Directory'}if ($itemInfo -is [System.IO.DirectoryInfo]){$size = (Get-ChildItem -Path $item -Recurse -Force | Measure-Object -Property Length -Sum).Sum}else{$size = (Get-Item $item).Length}$sizeInSpecifiedUnit = $size / $unitMultiplier[$Unit]Write-Verbose "`$sizeInSpecifiedUnit: $sizeInSpecifiedUnit"$Size = [math]::Round($sizeInSpecifiedUnit, [int]$Precision)Write-Verbose "`$size: $Size"if ($PrecisionFormatTable){$size = "$size"}$res = [PSCustomObject]@{Mode     = $ModeBaseName = $baseNameSize     = $Size #默认打印数字的时候只保留小数点后2位Unit     = $Unit}$verbo = [pscustomobject]@{Itemtype = $itemTypePath     = $item}if ($Detail){# $res | Add-Member -MemberType NoteProperty -Name FullPath -Value (Convert-Path $item)foreach ($p in $verbo.PsObject.Properties){$res | Add-Member -MemberType NoteProperty -Name $p.Name -Value $p.value}}if ($FormatTable){$res = $res | Format-Table #数据表格化显示}return $res}else{Write-Warning "路径不存在: $item"}}}
}

用例:除了函数内部的文档和例子,在举例

PS🌙[BAT:79%][MEM:36.5% (11.58/31.71)GB][21:52:37]
# [cxxu@CXXUCOLORFUL][<W:192.168.1.178>][C:\repos\c_cpp_consoleapps\cpp\archives]
PS> Get-Size .\12.1.1.1类的构造函数.cppMode  BaseName             Size Unit
----  --------             ---- ----
-a--- 12.1.1.1类的构造函数 0.00 MBPS🌙[BAT:79%][MEM:37% (11.73/31.71)GB][21:56:57]
# [cxxu@CXXUCOLORFUL][<W:192.168.1.178>][C:\repos\c_cpp_consoleapps\cpp\archives]
PS> Get-Size .\12.1.1.1类的构造函数.cpp -Unit BMode  BaseName               Size Unit
----  --------               ---- ----
-a--- 12.1.1.1类的构造函数 946.00 BPS🌙[BAT:79%][MEM:36.93% (11.71/31.71)GB][21:57:05]
# [cxxu@CXXUCOLORFUL][<W:192.168.1.178>][C:\repos\c_cpp_consoleapps\cpp\archives]
PS> Get-Size .\12.1.1.1类的构造函数.cpp -Unit KBMode  BaseName             Size Unit
----  --------             ---- ----
-a--- 12.1.1.1类的构造函数 0.92 KB

对指定目录以友好的格式列出所有文件和子目录的大小

用例可以参考函数内部的注释文档.Example

这个函数对于我们想要分析某个文件夹中文件占用很有用

function Get-ItemSizeSorted
{<# .SYNOPSIS对指定目录以文件大小从大到小排序展示其中的子目录和文件列表.DESCRIPTION继承大多数Get-Size函数的参数,比如可以指定文件文件大小的单位，大小数值保留的小数位数等(详情请参考Get-Size函数)。.EXAMPLEPS🌙[BAT:79%][MEM:44.53% (14.12/31.71)GB][0:00:19]# [cxxu@CXXUCOLORFUL][<W:192.168.1.178>][C:\repos\scripts\PS]PS> get-ItemSizeSorted -Unit KBMode  BaseName                          Size Unit----  --------                          ---- ----da--- Deploy                           82.45 KBda--- Basic                            78.55 KBd---- Pwsh                             49.91 KBd---- TaskSchdPwsh                     40.06 KB#>param ($Path = '.',[Parameter(Mandatory = $false)][ValidateSet('B', 'KB', 'MB', 'GB', 'TB')][string]$Unit = 'MB',#文件大小精度$Precision = 3,[switch]$Detail,[switch]$PrecisionFormatTable,[switch]$FormatTable)$res = Get-ChildItem $Path | ForEach-Object {$_ | Get-Size -Unit $Unit -Precision $Precision -Detail:$Detail `-PrecisionFormatTable:$PrecisionFormatTable # -FormatTable:$FormatTable }$sorted = $res | Sort-Object -Property size -Descendingif ($FormatTable){$sorted = $sorted | Format-Table}return $sorted
}

函数灵活性说明👺

函数Get-Size支持管道符,对于灵活性大有好处,如果Get-Size在筛选方面不能满足需要,那么可以借助ls配合其他过滤命令,然后将过滤到的项目传递给Get-Size来计算,例如

PS [C:\exes]> ls *exe|Get-Size|sort size -DescendingMode  BaseName                                                  Size Unit
----  --------                                                  ---- ----
-a--- WeChatSetup                                             270.29 MB
-a--- WetypeSetup                                             155.75 MB
-a--- windhawk_setup_offline                                  131.79 MB
-a--- GeForce_Experience_v3.27.0.120                          125.82 MB
-a--- WantDiffusionSetup                                       93.07 MB
-a--- Twinkle.Tray.v1.15.4                                     84.24 MB
-a--- Miniconda3-py311_24.1.2-0-Windows-x86_64                 81.00 MB
-a--- alist                                                    77.83 MB
-a--- typora-setup-x64-1.5.12                                  77.18 MB
-a--- Whale                                                    77.06 MB
-a--- audiorelay-0.27.5                                        68.22 MB
-a--- Git-2.44.0-64-bit                                        62.32 MB
...

综合用例

计算指定目录或文件的大小

# [cxxu@CXXUCOLORFUL][<W:192.168.1.178>][C:\repos\scripts]{Git:main}
PS> get-size .Mode  BaseName  Size Unit
----  --------  ---- ----
da--- scripts  55.37 MB

PS🌙[BAT:79%][MEM:37.62% (11.93/31.71)GB][22:08:54]
# [cxxu@CXXUCOLORFUL][<W:192.168.1.178>][C:\repos\scripts]{Git:main}
PS> get-size .\debug.log -Unit KBMode  BaseName Size Unit
----  -------- ---- ----
-a--- debug    0.12 KBPS🌙[BAT:79%][MEM:37.65% (11.94/31.71)GB][22:09:19]
# [cxxu@CXXUCOLORFUL][<W:192.168.1.178>][C:\repos\scripts]{Git:main}
PS> get-size .\debug.log -Unit KB -DetailMode     : -a---
BaseName : debug
Size     : 0.12
Unit     : KB
Itemtype : File
Path     : .\debug.log

指定单位为MB来分析文件占用比较实用,甚至可以指定GB来分析,无论是子目录还是文件,都可以被统计大小排列顺序(默认是从大到小排序,如果有需要,可以后续再用一次|Sort排序,但是不能和-PrecisoinFromatTable参数混用)

PS> get-itemSizeSorted -Unit MB -Precision 4 -PrecisionFormatTableMode  BaseName               Size    Unit
----  --------               ----    ----
d---- .mypy_cache            52.7167 MB
da--- PS                     0.5515  MB
d---- Cpp                    0.3968  MB
d---- sample1                0.3202  MB
da--- linuxShellScripts      0.0608  MB
d---- pythonScripts          0.0582  MB
d---- data                   0.0559  MB
-a--- PwshModuleByCxxu       0.0282  MB
d---- jsScripts              0.0168  MB
-a--- LICENSE                0.011   MB
d---- antlr                  0.0085  MB
d---- .vscode                0.0024  MB
d---- windows                0.002   MB
d---- Config                 0.0015  MB
-a--- readme_zh              0.0009  MB

顺序(升序)排列

PS> get-itemSizeSorted -Unit MB |sort sizeMode  BaseName                Size Unit
----  --------                ---- ----
-a--- readme                  0.00 MB
....(节约篇幅)-a--- readme_zh               0.00 MB
d---- windows                 0.00 MB
d---- .vscode                 0.00 MB
d---- antlr                   0.01 MB
-a--- LICENSE                 0.01 MB
d---- jsScripts               0.02 MB
-a--- PwshModuleByCxxu        0.03 MB
d---- data                    0.06 MB
d---- pythonScripts           0.06 MB
da--- linuxShellScripts       0.06 MB
d---- sample1                 0.32 MB
d---- Cpp                     0.40 MB
da--- PS                      0.55 MB
d---- .mypy_cache            52.72 MB

其他相关软件

• Onecommander OneCommander - Modern files manager for Windows 11 and Windows 10

  • 是一款扩展了windows资源管理器(explorer)的软件,可以启用目录占用大小的功能(这会引起高的cpu占用,灵活性不如单独计算指定目录的供,windows自带的资源管理器虽然默认计算文件夹大小,但是可以右键属性单独查看指定目录占用大小)

• eza eza-community/eza: A modern alternative to ls (github.com)

  • 在windows平台上功能受限

易用系列

• 利用everything排序(高性能),文件索引完毕后,指定目录,选择size排序
  • 软件官网https://www.voidtools.com/