一、为什么我要整理这份报错清单？
我自学编程那会儿，最怕的不是写不出代码，而是写完之后一运行，屏幕上一堆红色英文。那时候我英语也不好，看到SyntaxError就直接懵了。后来工作了，带新人，发现他们遇到报错的第一反应也是关掉终端重来——以为重启就能好。
其实每个报错都是程序在告诉你它哪里不舒服。你听懂它在说什么，问题就解决了一大半。今天我把自己这些年写Hello World时踩过的、教别人时见过的报错，按语言分类整理出来，每个都附上原因和解决办法。这不是什么高深的理论，就是实实在在的踩坑记录。
二、Python的报错，新手最容易中招
错误1：SyntaxError: invalid character in identifier
代码我抄的是print（"Hello"），括号是中文全角的。这个错在中文输入法下太常见了。解决办法就是把所有标点切换成英文半角。我现在的习惯是写代码之前先把输入法切到英文，写完再切回来。
错误2：NameError: name 'print' is not defined
有个朋友把print写成了Print，Python是大小写敏感的，print是内置函数，Print不是。解决办法就是检查函数名的大小写。
错误3：IndentationError: expected an indented block
代码里if后面直接写了print，没有缩进。Python用缩进来表示代码块，如果你在条件判断、循环或函数定义后面忘了缩进，就会报这个。解决办法是在冒号后面按一下Tab或四个空格。
错误4：TabError: inconsistent use of tabs and spaces in indentation
这是缩进里混用了Tab和空格。有些编辑器默认用Tab，有些用空格，混在一起Python就懵了。解决办法是在编辑器设置里把”Tab转换为空格”勾上，或者统一用空格。
错误5：SyntaxError: Missing parentheses in call to 'print'
这是把Python 2的print "Hello"写在了Python 3里。Python 3的print是函数，必须带括号。解决办法就是加上括号。如果你不确定自己用的是哪个版本，在终端输入python --version看一下。
错误6：UnicodeEncodeError: 'ascii' codec can't encode character
我试过在代码里写print("你好")，终端是英文环境，编码是ASCII，中文出不来。解决办法是在代码开头加上# -*- coding: utf-8 -*-，或者把终端的编码改成UTF-8。现在Python 3默认UTF-8，一般不会遇到，但如果你用的是Python 2或者终端配置特殊，就可能中招。
三、Java的报错，规矩多到让人抓狂
错误7：javac: file not found: HelloWorld.java
编译时文件名写错了，或者文件不在当前目录。解决办法是先用dir（Windows）或ls（Mac/Linux）看看文件名到底是什么，然后输入正确的文件名。
错误8：错误: 类HelloWorld是公共的，应在名为HelloWorld.java的文件中声明
Java要求公共类的类名和文件名完全一致，包括大小写。如果你类名叫HelloWorld，文件名就得是HelloWorld.java。解决办法就是把文件名改对，或者把类名改成跟文件名一样。
错误9：错误: 找不到或无法加载主类 HelloWorld
编译通过了，但java HelloWorld时报这个错。常见原因有：类名写错了（比如大小写不对），或者没有在编译后的class文件所在目录执行。解决办法是检查类名拼写，然后确保你在编译输出目录下运行java命令。
错误10：编码GBK的不可映射字符
这个错在Windows中文系统下很常见。因为你的源码是UTF-8保存的，但javac默认用GBK读取。解决办法是在编译时指定编码：javac -encoding UTF-8 HelloWorld.java。
错误11：需要class, interface或enum
把方法写到了类外面。比如：
java
复制
public class Hello {
}
System.out.println("Hello"); // 这行不在任何方法里
解决办法是把所有可执行语句都放到方法里，比如main方法。
错误12：找不到符号 符号: 变量 system
把System写成了system，Java大小写敏感。解决办法是注意System、String这些类首字母大写。
四、C语言的报错，每一个都像天书
错误13：error: expected ';' before '}'
忘加分号了。C语言每个语句后面都必须有分号，特别是printf那一行。解决办法是检查最后一行是不是漏了分号。
错误14：undefined reference to 'printf'
这个错在嵌入式或特定环境下出现过。因为没有链接标准库。解决办法是编译时加上-lc链接libc，但通常gcc默认会链接，所以如果出现这个错，可能是你的环境有问题。
错误15：warning: implicit declaration of function 'printf'
忘了包含头文件#include <stdio.h>。C语言规定函数调用前要先声明，printf的声明在stdio.h里。解决办法是加上这一行。
错误16：fatal error: stdio.h: No such file or directory
编译器找不到标准头文件。这通常是环境没装全，比如Alpine Linux需要额外装musl-dev或者libc-dev。解决办法是安装对应的开发包。
五、Go语言的报错，module问题占大头
错误17：package command-line-arguments: cannot find package
在Go 1.16+版本中，如果不在module里，直接go build会报错。解决办法是先执行go mod init 模块名创建module，再编译。
错误18：undefined: fmt
代码里用了fmt.Println，但没有import "fmt"。解决办法是加上导入声明。
错误19：func main is not main package
如果你的package不是main，Go没法生成可执行文件。解决办法是把package改成main。
六、Docker的Hello World，网络问题居多
错误20：dial tcp: lookup registry-1.docker.io: no such host
拉取镜像时DNS解析失败。在国内很常见。解决办法是配置国内镜像加速器，比如阿里云、中科大，在/etc/docker/daemon.json里加上"registry-mirrors": ["https://xxx.mirror.aliyuncs.com"]，然后重启docker服务。
错误21：permission denied while trying to connect to the Docker daemon socket
执行docker run时权限不足。解决办法是把当前用户加到docker组：sudo usermod -aG docker $USER，然后重新登录。
七、环境变量相关的通用报错
错误22：'python' 不是内部或外部命令（Windows）
安装Python时没勾”Add Python to PATH”。解决办法是重装，或者手动把Python安装目录和Scripts目录加到系统环境变量里。
错误23：bash: python: command not found（Mac/Linux）
python3已安装，但命令是python3而不是python。解决办法是用python3 hello.py运行，或者在~/.bashrc里设置别名alias python=python3。
八、排查报错的一般步骤
我把这些错都踩过一遍后，总结了一套通用的排查流程：
第一步，看报错类型。SyntaxError是语法问题，NameError是名字拼错，IndentationError是缩进，ImportError是导入，FileNotFoundError是文件路径。类型告诉你该往哪个方向查。
第二步，看报错行号。大多数错误都会告诉你第几行出问题，先从那行看起，但有时候真正的问题在上面一行（比如上一行少了括号）。
第三步，把报错信息复制到搜索引擎里。不要自己瞎猜，把完整的错误信息（最好加上语言）贴进去，大概率有前人遇到过。
第四步，检查标点符号。中文标点、少了分号、括号不配对，这些占据了我新手时期80%的错误。先把这些排除，再看别的。
第五步，检查环境版本。你的Python是2还是3？Java版本够不够？Go的module模式开了没？版本不匹配会带来很多奇怪的问题。
九、最后说一句
写完这篇，我突然觉得Hello World像是一道门槛。它本身就很简单，但你跨过它之前，可能会被这些红色报错绊倒无数次。这些报错本质上不是要难为你，而是你的代码在和编译器/解释器对话——它在说”你这里没说清楚”或者”你给的格式我不认识”。
你每解决一个报错，就学会了一个新的规则。等你能顺利跑通Hello World的时候，你其实已经学会了怎么跟这台机器交流了。它虽然唠叨，但只要你耐心听，它每次都告诉你该怎么做。希望这份报错清单，能让你少走一些我当年走过的弯路。
