git sparse checkout部分检出的配置【攻略】
Git sparse checkout仅控制工作区路径显示，不减少对象下载；真正省空间需结合partial clone（--filter=blob:none）与--cone模式初始化，并用reapply刷新工作区。 Git sparse checkout 听起来像“只拉几个文件进来”，但实际没那么简
Git sparse checkout仅控制工作区路径显示，不减少对象下载；真正省空间需结合partial clone（--filter=blob:none）与--cone模式初始化，并用reapply刷新工作区。
Git sparse checkout 听起来像“只拉几个文件进来”，但实际没那么简单——它管的是工作区里能看到哪些路径，对象库该下多大还是下多大。想省磁盘、省带宽，得把 partial clone 和 sparse-checkout 绑在一起用，否则只是“表面轻量”。
git sparse-checkout init --cone 是当前最稳的起点
别再用老办法往 .git/info/sparse-checkout 里一行行 echo 路径了。Git 2.25+ 推荐 git sparse-checkout init --cone，它启用“锥形模式”（cone mode），规则更简洁、性能更好、也少踩坑。
--cone模式下，指定目录名（比如torch/nn），Git 自动包含它的所有子目录，外加所有父级路径（像torch/和根目录下的setup.py）- 不加
--cone就是传统非锥形模式，得写!/docs/**这种 gitignore 风格规则，容易漏、难调试 - 执行后 Git 自动设置
core.sparseCheckout=true和core.sparseCheckoutCone=true，并生成带注释的.git/info/sparse-checkout
只检出、不下载：必须加 --filter=blob:none
光开 sparse-checkout 不管用。如果你先 git clone 再 git sparse-checkout set，Git 还是会把整个仓库的 blob（文件内容）全拉到 .git/objects 里——只是不解压到工作区而已。真正节省空间，得从克隆那一刻就过滤。
- 正确做法：
git clone --filter=blob:none --no-checkout，进目录后git sparse-checkout init --cone && git sparse-checkout set torch/nn torch/cuda setup.py --filter=blob:none表示跳过所有文件内容下载；后续首次访问某个文件时，Git 会按需 fetch（lazy fetch）- 注意：该参数要求远程服务器支持 protocol v2（GitHub、GitLab 2021 年后基本都支持，自建 Gitea/GitServer 需确认）
git sparse-checkout set 后工作区没更新？试试 reapply
常见场景：执行 git sparse-checkout set src/web components/ui 后，src/web 目录空空如也，git status 也显示 clean。这不是失败，而是 Git 没触发重检出。
- 运行
git sparse-checkout reapply强制重新应用规则，把匹配路径的文件从索引写入工作区 - 如果提示 “error: Your local changes would be overwritten”，说明那些路径下已有未跟踪文件（比如你手动创建过
src/web/index.html），Git 不敢覆盖——先git clean -fd或手动删掉冲突文件 - 也可以用
git read-tree -m -u HEAD替代reapply，但更底层、风险略高，日常推荐reapply
切换分支时 sparse-checkout 规则会失效？不是 bug，是设计
在 sparse 模式下切分支，Git 默认只更新你“关心”的路径。比如在 main 分支只检出了 src/web，切到 feat/api 后，src/web 会更新，但 src/backend 即使该分支有改动也不会出现在工作区——这是预期行为，不是卡住了。
- 如果某次切分支后发现关键文件“消失”，先运行
git sparse-checkout list确认当前规则是否还在 - 需要临时看全量？用
git sparse-checkout disable，它会清掉 SKIP_WORKTREE 标志并恢复全部文件（但不会重新下载 blob） - 注意：
git commit -a在 sparse 模式下**不会**把未检出路径里的修改当删除处理，这点和直觉相反，但能避免误删
真正麻烦的从来不是怎么配 sparse-checkout，而是团队协作时别人没开、CI 流水线没设 filter、或者某个脚本硬编码了 ls src/ 却忘了目录可能根本不存在——这些地方比命令本身更容易翻车。
Compressor 是 Apple 面向 Mac 推出的专业媒体转码与交付工具，可与 Final Cut Pro、Motion 协同工作。它支持批量任务、自定义编码预置、HDR 与广色域处理、字幕、空间视频、专业媒体格式及多台 Mac 分
Apple Motion 是苹果面向 Mac 视频创作者推出的动态图形与视觉特效工具，可制作二维及三维字幕、转场、粒子动画、对象跟踪和合成效果，并能将自定义模板直接用于 Final Cut Pro。
Archicad是Graphisoft推出的建筑信息模型设计软件，可在Mac上完成概念设计、参数化建模、图纸编制、工程量统计、渲染展示及团队协同。模型与平立剖面、明细表和布局保持关联，适合建筑师、室内设计师、BIM团队及相关专业学生使用。
AutoCAD LT是Autodesk推出的专业二维CAD设计与文档编制软件，Mac版本提供原生界面、多点触控及分屏查看体验。用户可精确创建和编辑DWG图形，完成图层管理、尺寸标注、表格、PDF参考、外部参照及打印输出。
AutoCAD for Mac 是 Autodesk 面向 macOS 提供的专业计算机辅助设计软件，支持精确的二维绘图、标注、布局输出以及实体、曲面和网格建模。软件采用适配 Mac 操作习惯的界面，可处理 DWG 图纸。
Autodesk Fusion 是面向产品设计与制造的一体化云连接平台，在 Mac 上提供参数化建模、自由曲面、装配、工程图、仿真、PCB 设计和 CAM 加工等工具。它适合机械工程师、工业设计师、创客及制造团队使用。
Autodesk Maya是一套面向影视动画、游戏开发和视觉特效制作的专业三维创作软件，集多边形与曲面建模、角色绑定、关键帧动画、动力学模拟、程序化特效及Arnold渲染于一体，并提供脚本、插件和开放式制作管线支持。
Blender是一款免费开源的综合三维创作软件，可在Mac上完成建模、数字雕刻、材质制作、角色绑定、动画、物理模拟、渲染、合成及视频剪辑。软件提供Cycles与Eevee渲染工具，并支持几何节点、蜡笔绘制和Python扩展。
BricsCAD 是一款以原生 DWG 为核心的专业 CAD 软件，可在 Mac 上完成二维绘图、标注、图纸管理及三维建模。产品提供 Lite、Pro、BIM、Mechanical 和 Ultimate 等授权层级。
Capture One Pro 是面向摄影师、数码技术员和商业影像团队的专业后期软件，提供高质量RAW解析、精细色彩控制、图层蒙版、目录与会话管理，以及业内领先的联机拍摄工作流。Mac用户可通过官方安装包部署。
Cinema 4D是Maxon推出的专业三维创作软件，适合动态设计、广告包装、产品可视化、影视特效及游戏资产制作。软件将建模、角色动画、MoGraph程序化运动、动力学模拟与Redshift GPU渲染整合在统一工作环境中。
Cubase 是 Steinberg 推出的专业数字音频工作站，适用于歌曲创作、录音、MIDI 编曲、影视配乐、混音及母带制作。Mac 版提供完整的多轨制作环境，并集成虚拟乐器、效果器、音高修正、节奏设计和乐谱编辑工具。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件，支持 Windows、macOS 和 iPad 等平台，广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件，集建模、动画、渲染、视频编辑与视觉合成等功能于一体，广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎，并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统，安装包轻巧、运行流畅，依托活跃的全球开发者社区持续更新，是从初学者到专业创作者都值得选择的正版 3D 创作工具。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。