项目文件整理

文件夹不是麻烦,是项目能继续长大的骨架。

当一个项目只有一两个文件时,随便放也能看懂。等页面、图片、样式、脚本和内部文档变多,如果没有结构,很快就会找不到东西。

READMETODOassetsCSSJS

这是什么

项目文件告诉你:这个项目是什么、做到哪、怎么运行。

它解决的问题是“换一天回来就忘了”。好的项目文件能让你、GPT 和 Codex 都更快进入状态。

README 文件

项目说明书。写项目用途、预览方式、主要文件和注意事项。

TODO.md

待办清单。写接下来要做什么,最好按优先级排序。

PROJECT_MEMORY.md

项目记忆。记录重要背景、长期规则和已经确认的方向。

DEPLOY_CHECKLIST.md

发布前检查表。提醒你检查链接、图片、公开边界和页面显示。

assets / images

放图片、图标、截图等资源。公开站只放适合公开展示的图片。

styles.css / script.js

styles.css 管视觉样式,script.js 管轻量交互,比如移动端菜单和滚动显示。

公开边界

不是所有项目资料都应该上传到公网。

内部说明、聊天记录、未确认内容、个人资料、临时文件,都应该先留在本地或私有资料库。公开目录只放用户需要看的页面和安全资源。

部署前备份

先保留一份原始项目,再创建公开展示版,避免误删重要内容。

公开目录更干净

公开目录只放 HTML、CSS、JS 和必要图片,不放内部说明。

发布前检查

检查链接是否可用、图片是否存在、是否混入本地路径或内部资料。

public-site/
  index.html
  styles.css
  script.js
  assets/
    hero-image.png
internal-notes/
  project-context.md
  decisions.md
  todo.md

公开目录 / 内部目录对比

公开目录要干净,内部目录要完整。

一个项目可以有很多资料,但不代表它们都适合被访问者看到。发布前先分清楚,能减少很多后续麻烦。

可以公开

index.html
styles.css
script.js
assets/

这些是网页运行和展示需要的文件。

不建议公开

PROJECT_MEMORY.md
DEPLOY_CHECKLIST.md
内部交接文档
zip 压缩包
本机路径
账号信息

这些更适合留在本地资料库或私有项目里。

下一步去哪

文件整理清楚后,就可以理解个人网站怎么公开。

下一站会用新手能懂的话解释域名、服务器、DNS、HTTPS 和备案。