三亩地 三亩地SAN MU DI · CODE DIARY
BEGINNER GUIDE

零基础避坑指南

写给第一次打开编辑器的你。第一周学什么、环境怎么装、教程地狱怎么破——这一页全是过来人希望你早点知道的事。

零基础第一周学习路径 WEEK 01 · 起步
FIRST WEEK · 第一周

不要从 C++ 开始,从能立刻看到结果的东西开始

新手最大的误区是"先把基础打牢再动手"。编程不是数学,不动手永远学不会。第一周的目标只有一个:让你写下的字符变成屏幕上看得见的东西。

  • Day 1-2:装好编辑器(VS Code),写出第一个 HTML 页面
  • Day 3-4:用 CSS 给页面加颜色、布局、动效
  • Day 5-6:写第一段 JavaScript,让按钮能点击
  • Day 7:把这一周做的小东西部署上线,分享给朋友看

学会编程的第一步,是相信它没那么难

—— 三亩地 · 零基础寄语

ENV · 环境配置

第一周最容易卡住的五个报错

这些报错不是你的错,是工具链的历史包袱。认识它们、记下解法,下次再见就不会慌。

'node' 不是内部或外部命令

原因:Node.js 未安装或未加入 PATH。解决:去 nodejs.org 下载 LTS 版本,安装时勾选 Add to PATH。

npm install 卡住不动

原因:默认源是海外镜像。解决:切换淘宝镜像 npm config set registry https://registry.npmmirror.com。

Port 3000 is already in use

原因:上次没正常关掉进程。解决:Mac 用 lsof -i:3000 找 PID 再 kill;Windows 用 netstat -ano。

Permission denied (publickey)

原因:Git SSH key 未配置。解决:ssh-keygen 生成密钥,把 ~/.ssh/id_rsa.pub 内容贴到 GitHub。

VS Code 提示找不到模块

原因:依赖未安装。解决:在项目根目录执行 npm install,等进度条跑完再启动项目。

CORS 跨域报错

原因:浏览器同源策略。新手阶段直接在浏览器装 CORS 插件即可;上线要走后端配置。

ANTI · 教程地狱

别再一直看教程了动手做点东西

教程地狱(Tutorial Hell):你看了一个又一个视频,感觉都听懂了,关掉视频却一行也写不出来。下面是从中走出来的方法。

教程是脚手架,不是轮椅。学骑车时它扶着你,但你得自己蹬起来,不然永远学不会。

— 三亩地 · 教程地狱笔记

看完立刻做个变体

教程教你做待办清单,你就改成读书清单;改 UI、改字段、改逻辑,强迫大脑主动调用知识,而不是被动接收。

方法 · 01 高频使用

不带教程做一遍

学完一个完整教程后,关掉它,凭记忆把同样的东西再做一遍。卡住的地方才回去看——这才是真不懂的地方。

方法 · 02 强烈推荐

给自己出题

学完 HTML/CSS,自己设计一个 landing page;学完 JS,做一个倒计时。从需求出发,比从教程出发学得快。

方法 · 03 长期有效
RESOURCES · 入门资源

三个不踩雷的入门资源

资源不在多,在精。下面三个是三亩地长期使用并推荐的,新手照着学不会走偏。

MDN Web Docs 入门文档配图 DOCS

MDN Web Docs

Mozilla 官方文档,HTML/CSS/JS 权威来源。新手不用全读,遇到不会的就查,逐步熟悉。

权威 · 免费 查看推荐 →
freeCodeCamp 入门课程配图 COURSE

freeCodeCamp 响应式设计

免费互动课程,300 小时通关前端基础。每节都配练习题,适合完全零基础。

互动 · 免费 查看推荐 →
JavaScript.info 入门教程配图 BOOK

现代 JavaScript 教程

javascript.info 中文版,从变量到原型到异步讲得最清晰的入门书,配大量可运行示例。

系统 · 免费 查看推荐 →

你不是学不会,是没人告诉你前面有什么。这一页就是给你提前点亮的那盏灯。

— 三亩地 · 零基础寄语