在跨平台桌面或后台服务开发中，经常需要确认当前登录用户在某块磁盘上的配额上限与已用空间，以便提前提示用户清理文件或限制上传。C#本身没有统一的跨平台配额查询类，必须针对Windows和Linux分别调用系统能力。下面先说明具体方案，再给出可运行代码。
Windows平台配额查询原理
Windows的NTFS磁盘配额以卷为单位，记录每个安全标识符（SID）对应的磁盘使用上限与警告阈值。系统将配额信息保存在卷根目录的隐藏系统文件里，并通过WMI类Win32_DiskQuota暴露。另一种方式是使用kernel32.dll中的GetDiskFreeSpaceEx获取卷总空间，但该函数不直接返回用户级配额，仅能拿到调用者可见的可用字节，因此精确配额仍要走WMI或FSRM API。
使用WMI查询时，需要以管理员或具有相应权限的账户运行程序，否则很多字段会返回空。同时Win32_DiskQuota中的QuotaVolume属性对应卷路径，User属性为账户名，DiskSpaceUsed与Limit分别为已用和上限字节数。下面的例子演示如何通过ManagementObjectSearcher拿到本机C盘上某用户的配额。
using System;
using System.Management;
class WindowsQuota
{
static void Main()
{
// 查询C盘配额，筛选指定用户
string query = "SELECT * FROM Win32_DiskQuota WHERE QuotaVolume = 'C:' AND User = 'DOMAIN\user1'";
using (ManagementObjectSearcher searcher = new ManagementObjectSearcher(query))
{
foreach (ManagementObject mo in searcher.Get())
{
ulong used = (ulong)mo["DiskSpaceUsed"];
ulong limit = (ulong)mo["Limit"];
Console.WriteLine("已用: " + used + " 字节, 上限: " + limit + " 字节");
}
}
}
}
上述代码在域环境或本地账户下都能工作，但注意User字段格式必须和系统一致。若只需快速判断剩余配额，也可调用GetDiskFreeSpaceEx，它虽不区分用户，但适合做粗粒度校验。实际项目里建议优先WMI拿精确值，失败再降级到卷级别可用空间。
Linux平台配额获取方式
Linux配额由quota软件包管理，常见文件系统如ext4、xfs在挂载时需指定usrquota选项。系统命令quota -u username可输出该用户在各挂载点的块限制与已用值。C#在Linux下没有原生配额库，通常借助System.Diagnostics.Process启动quota命令并解析标准输出，这就要求运行环境已安装quota工具且程序有权限执行。
解析时要留意不同发行版输出列顺序可能不同，有的用块数，有的直接给GB。更底层的方式是读取aquota.user文件，但格式随版本变化，维护成本高。下面示例展示调用quota命令并简单拆分结果，适合大多数主流发行版。
using System;
using System.Diagnostics;
class LinuxQuota
{
static void Main()
{
Process p = new Process();
p.StartInfo.FileName = "quota";
p.StartInfo.Arguments = "-u user1";
p.StartInfo.RedirectStandardOutput = true;
p.StartInfo.UseShellExecute = false;
p.Start();
string output = p.StandardOutput.ReadToEnd();
p.WaitForExit();
// 简单按行解析，忽略表头
foreach (string line in output.Split('n'))
{
if (line.Contains("/"))
{
string[] cols = line.Split(new char[]{' '}, StringSplitOptions.RemoveEmptyEntries);
Console.WriteLine("文件系统: " + cols[0] + " 已用: " + cols[2] + " 上限: " + cols[3]);
}
}
}
}
该方式在容器或精简镜像里可能因为没有quota命令而报错，此时应在代码里捕获异常并提示环境不支持。对于长期运行的服务，推荐把配额查询做成独立健康检查任务，避免每次写文件都触发进程启动带来的开销。
跨平台封装建议
为了让业务层不关心系统差异，可以定义统一接口IUserQuotaProvider，内含方法GetQuota(string user, string volume)，再分别实现WindowsWmiProvider与LinuxCommandProvider。上层通过RuntimeInformation.IsOSPlatform判断加载哪个实现，既清晰又方便单元测试。
权限方面，Windows服务若以LocalSystem运行通常能读配额，但Linux服务账户可能不在sudoers里，执行quota会被拒绝。部署文档应明确说明所需权限，否则排查时会浪费大量时间。此外，配额数值建议换算成GB再展示，避免用户面对长整型字节数产生困惑。
public interface IUserQuotaProvider
{
(ulong used, ulong limit) GetQuota(string user, string volume);
}
public class QuotaService
{
public IUserQuotaProvider Provider { get; set; }
public string Report(string user, string volume)
{
var (used, limit) = Provider.GetQuota(user, volume);
double usedGb = used / 1073741824.0;
double limitGb = limit / 1073741824.0;
return $"用户 {user} 在 {volume} 已用 {usedGb:F2}GB / 共 {limitGb:F2}GB";
}
}
这种结构在后期接入网络盘或云存储配额时，只需新增实现类，不影响原有逻辑。遇到查询失败，上层应记录日志并返回安全的默认值，防止界面崩溃。
常见误区与排查
一个容易混淆的概念是把卷的剩余空间当作用户配额。例如调用GetDiskFreeSpaceEx拿到的是卷级空闲，不是某账号上限，若系统开了配额，用户可能早已超限但卷还有空间。另一个误区是认为Linux所有目录都支持配额，实际上必须挂载时启用usrquota且文件系统支持，否则quota命令会显示none。
排查时先确认运行身份，再分别用系统自带工具（Windows的fsmgmt.msc或Linux的quota命令）手动验证，对比程序输出。若WMI返回空集，多半是权限或筛选字符串错误；若Linux解析错位，打印原始输出对照列头即可修正。把诊断步骤写进内部Wiki，能显著降低后续维护成本。
C#磁盘配额FileSystemWatcher修改时间：2026-08-05 16:48:32