docs: 更新常见问题及解决方案

docs/00.常见问题及解决方案/常见问题及解决方案.md

@@ -1,6 +1,5 @@
 
-## 1. 头文件跳转的问题
-
+## 1. 头文件无法跳转，没有代码提示
 #### **问题**：
 
 >我们使用VS Code打开ESP32项目，有时我们的代码头文件无法跳转，写代码没有代码提示。
@@ -43,3 +42,37 @@
 
 ![](attachments/20240129232230.png)
 
+## 2.开发板在Windows下可以显示端口，但在Linux下找不到
+
+#### **问题**：
+
+>开发板在Windows下可以显示端口，但在Linux下找不到
+
+这种情况一般是由于开发板的USB转串口芯片在Linux下没有驱动程序导致的，特别是USB转串口芯片为CH340的开发板，容易找不到驱动。（所以推荐使用USB转串口芯片型号为CP210x的开发板）。
+#### 解决方案：
+
+安装对应型号的串口驱动程序，上网搜索安装教程一般都能找到。
+
+
+## 3.Linux下烧录代码报错（没有串口权限）
+
+#### **问题**：
+
+>Linux下烧录代码报错（没有串口权限）
+
+在Linux下烧录代码，后可能会出现：
+
+![](attachments/20250107091923.png)
+
+这是由于我们的linux用户没有读写串口的权限
+#### 解决方案：
+
+可以使用下面的命令添加串口读写权限（也可直接切换root用户）：
+
+```
+sudo chmod a+rw /dev/ttyUSB0
+```
+
+但是注意`sudo chmod a+rw /dev/ttyUSB0` 的权限更改是暂时的，只会在当前设备被使用的会话期间生效。一旦系统重启或者设备断开并重新连接，设备节点（例如 /dev/ttyUSB0）可能会重新被创建，且权限会被重置为默认状态。
+
+可以使用下面的命令，永久为用户添加串口权限：`sudo usermod -aG dialout username`，设置后重启方能生效。