Skip to content

Programmer File Management: Beyond Code

配图

Programmers have code management handled by Git. But project-related documents, requirements specs, design files, and log files scatter everywhere without any structure.

Code repositories are pristine. Desktops are disaster zones. This is the real state of many programmers.

What Makes Programmer File Management Special

Section titled “What Makes Programmer File Management Special”

Programmers face unique file management challenges:

① Temporary files are numerous and constantly replaced Build artifacts, log files, intermediate compilation files — these not only pile up but get overwritten repeatedly. Manual management can’t keep up.

② Document formats are diverse Beyond code: Markdown, PDF, Word, Excel, images, PlantUML diagrams…… all mixed together, easy to lose track of.

③ Versioning needs are strong Code has Git. But what about documents outside code? Requirements change logs, design review records, API doc history — usually no version control.

④ Multi-person collaboration scatters files Team members each handle different modules. Documents scatter across individual computers. Unified management relies on individual discipline.

Core Principles of Programmer File Management

Section titled “Core Principles of Programmer File Management”

Principle 1: Files outside code need structure too

Don’t treat “code repository” as the only management tool. All project-related files should have a fixed directory structure:

D:\Projects\
├── ProjectA\
│ ├── docs\ # All documents
│ ├── design\ # Design files
│ ├── specs\ # Requirements
│ ├── notes\ # Personal notes
│ └── logs\ # Log files (regularly cleaned)

Code manages code. Documents manage documents. But everything lives under the same project directory.

Principle 2: Use rules engines for temporary files

Log files, build artifacts, node_modules, pycache — these don’t need manual management. Use rules engines:

  • {Project}\logs\* → Compress archive → Regular cleanup
  • {Downloads}{.zip}{contains "node_modules"} → Delete (not needed)
  • {Project}\dist\*D:\Projects\ProjectA\dist\{date}\ (versioned backup)

Principle 3: Document naming conventions matter

Like designer assets, programmer technical documents need standardized naming:

{Project}_{DocType}_{Date}_{Version}ProjectA_Requirements_20260315_v2.md

This makes search work by filename — no need to open files to find the right version.

Principle 4: Team files need shared rules

Team members agree on a unified file storage structure:

  • All requirements docs → \\SharedServer\ProjectA\docs\requirements\
  • All API docs → \\SharedServer\ProjectA\docs\api\

Rules engines auto-route received files to the right shared directory by type, reducing scattered documents across team member computers.

Three Operations Programmers Should Automate Most

Section titled “Three Operations Programmers Should Automate Most”

① Regular log archiving

Log files are the “garbage” programmers deal with most. Set rules: {Project}\logs\*.log → Weekly compress archive → D:\Archive\logs\{Project}\{year}\{month}

② Development environment temporary files

node_modules, venv, target, dist — these don’t need version control but consume huge amounts of space. Rules: {Project}{node_modules} → Compress backup then delete, or add to .gitignore + regular cleanup rules.

③ Technical documents from browser/email

Interface docs, design specs, meeting notes sent by colleagues — auto-route to D:\Projects\{Project}\docs\, no manual moving.

The most common feedback from programmers using rules engines: “I never have to scroll through WeChat chat history to find a document again.”

When files auto-enter the correct project directory, your sense of control over a project increases dramatically.

Code has Git management. Files have rules management. That’s the file management style programmers deserve.


Related articles:

Cover