如何建立个人脚本清单，记录所有脚本及其存储位置？

基础手动清单模板 #

先从最易落地的Markdown表格开始，不用复杂工具，直接维护：

把这个表格存成Script-Inventory.md，放在你常用的脚本根目录下，每次新增、移动脚本时更新一行即可。

自动化维护技巧 #

手动更新容易遗漏，用脚本自动生成清单更省心：

PowerShell 自动生成脚本清单 #

写个小脚本定期扫描指定目录，自动生成或更新清单：

# 定义要扫描的脚本根目录
$scriptRoots = @("D:\Scripts", "E:\Tools")
# 定义清单输出路径
$inventoryPath = "D:\Script-Inventory.md"

# 生成表格头部
$tableHeader = "| 脚本名称 | 存储路径 | 功能描述 | 最后修改时间 |`n|----------|----------|----------|--------------|"
$tableRows = @()

# 遍历指定后缀的脚本文件（可按需拓展：.ps1,.bat,.py等）
Get-ChildItem -Path $scriptRoots -Include "*.ps1","*.bat","*.py" -Recurse | ForEach-Object {
    # 读取脚本前5行的注释作为功能描述
    $description = Get-Content $_.FullName -TotalCount 5 | Select-String -Pattern "^#.*" | Select-Object -First 1 | ForEach-Object { $_.Line.TrimStart("# ").Trim() }
    if (-not $description) { $description = "未添加描述" }
    
    $tableRows += "| $($_.Name) | $($_.FullName) | $description | $($_.LastWriteTime.ToString('yyyy-MM-dd')) |"
}

# 写入清单文件
$tableHeader + "`n" + ($tableRows -join "`n") | Out-File -Path $inventoryPath -Encoding utf8

可以把这个脚本设成每周自动任务，或者每次新增脚本后手动执行一次，减少手动维护成本。

脚本头部规范 #

给每个脚本加固定格式的头部注释，让自动生成的清单信息更完整：

# 脚本名称：Get-FolderPerms.ps1
# 功能：批量获取指定文件夹的NTFS权限，输出为CSV格式
# 创建日期：2024-03-10
# 存储路径：D:\Scripts\PowerShell\

本地检索辅助 #

就算有清单，偶尔还是会记混，搭配本地检索工具更保险：

• Windows上用Everything，直接搜脚本名称或功能关键词，秒定位文件路径
• 把常用脚本根目录加到系统环境变量Path里，需要调用脚本时直接在命令行输入脚本名即可执行，不用手动输入路径

内容的提问来源于stack exchange，提问作者Nuisance