零门槛用Notion+Git LFS搭建轻量化研发项目档案管理软件全指南

一、前置准备：2个工具账号/环境

全程使用免费工具，无需购买服务器或付费订阅

• Notion账号：注册地址 https://www.notion.so/signup，用邮箱即可，免费版完全够用
• Git LFS环境：
  • Windows：下载Git for Windows自带LFS，地址 https://git-scm.com/downloads/win，安装时一路默认即可
  • Mac：终端执行 brew install git-lfs，没有Homebrew先装 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  • Linux：Ubuntu/Debian执行 sudo apt-get install git-lfs，CentOS/RHEL执行 sudo yum install git-lfs

二、Git LFS大文件仓库初始化：存研发核心资产

研发档案中的源码、二进制包、文档视频用Notion存容量/下载都受限，Git LFS免费版提供1GB初始存储+1GB每月带宽，完全覆盖中小项目前期需求

2.1 注册GitHub/GitLab账号（二选一，推荐GitHub免费版）

GitHub注册地址 https://github.com/signup，GitLab地址 https://gitlab.com/users/sign_up

2.2 创建私有Git LFS仓库

• 登录GitHub后点击右上角「+」→「New repository」
• Repository name填「project-dev-archives」（或自定义项目名）
• Privacy勾选「Private」
• 勾选「Add a README file」，点击「Create repository」

2.3 本地克隆仓库并初始化Git LFS

找一个本地文件夹，右键选择「Git Bash Here」（Windows）/ 打开终端（Mac/Linux），依次执行：

```bash 1. 克隆仓库（替换为你的仓库地址） git clone https://github.com/你的GitHub用户名/project-dev-archives.git 2. 进入仓库目录 cd project-dev-archives 3. 初始化Git LFS git lfs install 4. 指定LFS要追踪的大文件类型（按需添加，先加研发常用的） git lfs track ".zip" ".rar" ".tar.gz" ".exe" ".dmg" ".iso" ".mp4" ".pdf" ".doc" ".ppt" ".xls" ".drawio" ".psd" ".ai" 5. 把.gitattributes（LFS配置文件）加入Git git add .gitattributes 6. 提交初始配置 git commit -m "初始化Git LFS，配置常用大文件追踪" 7. 推送到远程仓库 git push ```

三、Notion数据库搭建：管研发档案索引

用Notion做“中央索引”，把Git LFS的下载链接、本地路径、档案信息整合到一起，方便快速检索

3.1 创建Notion数据库页面

• 登录Notion后点击左侧「+ New page」
• 输入页面名称「研发项目档案库」
• 点击页面空白处，输入「/database」，选择「Full page database」
• 修改数据库标题为「项目核心档案」

3.2 配置Notion数据库字段

点击数据库右上角「…」→「Properties」→「+ Add a property」，按以下顺序/配置添加，不需要的可以删除：

• 档案名称：默认Title字段，不用改
• 档案类型：Select类型，添加选项「需求文档」「设计文档」「源码快照」「测试报告」「部署手册」「会议纪要」「运维日志」
• 所属项目：Select类型，先留空，后续加项目名选项
• 上传时间：Created time类型，默认就行
• 责任人：Person类型，Notion免费版可添加最多5位协作者
• Git LFS链接：URL类型，必填项
• 状态：Select类型，添加选项「草稿」「审核中」「已归档」「已废弃」
• 备注：Text类型，可选

四、完整操作流程：上传+检索一份测试报告

以上传一份名为「V1.0.0登录模块测试报告.pdf」的档案为例，演示全流程

4.1 上传文件到Git LFS

• 把「V1.0.0登录模块测试报告.pdf」复制到本地「project-dev-archives」文件夹（可在文件夹下按项目名/类型创建子文件夹，比如先创建子文件夹「login-module」→「test-reports」，把文件放进去）
• 回到Git Bash/终端，依次执行： ```bash 1. 查看Git状态，确认文件被LFS追踪（会看到标记「(Git LFS)」） git status 2. 把所有修改加入Git git add . 3. 提交并写清楚提交信息（方便后续回溯） git commit -m "上传V1.0.0登录模块测试报告，包含压力/功能测试数据" 4. 推送到远程仓库 git push ```
• 获取Git LFS下载链接：登录GitHub仓库，找到对应文件，点击右上角「Raw」，复制浏览器地址栏的链接

4.2 在Notion添加档案索引

• 回到Notion「项目核心档案」数据库，点击「+ New」
• 档案名称填「V1.0.0登录模块测试报告.pdf」
• 档案类型选「测试报告」
• 所属项目如果有就选，没有就新增「用户中心V1.0.0」
• 责任人选自己
• Git LFS链接粘贴刚才复制的Raw链接
• 状态选「已归档」
• 备注可选填「压力测试并发1000通过」
• 点击空白处保存即可

4.3 快速检索与下载档案

在Notion数据库顶部搜索栏输入「登录模块测试」「V1.0.0」「责任人姓名」等关键词，直接定位；点击「Git LFS链接」自动跳转到浏览器下载页面

五、进阶优化：免费扩容Git LFS与协作者权限

5.1 免费扩容Git LFS存储/带宽

GitHub免费版LFS不够用的话，可以：

• 注册多个GitHub账号，分别创建仓库分项目存储
• 切换到Gitee，免费版提供5GB LFS存储+5GB每月带宽，注册地址 https://gitee.com/signup，操作流程完全一致

5.2 设置Notion/GitHub协作者权限

• Notion：点击页面右上角「Share」→输入协作者邮箱→选择权限（「Can edit」给研发/负责人，「Can view」给普通成员）
• GitHub：进入仓库「Settings」→「Collaborators」→「Add people」→输入协作者GitHub用户名/邮箱→选择权限（「Write」给开发，「Read」给普通成员）