小鸿AI开发环境搭建指南

小鸿AI开发环境搭建指南搞嵌入式或者 OpenHarmony 这类开发基本绕不开一个组合Ubuntu 负责编译烧录Windows 负责 IDE 写代码。两边的优势互补——Linux 有完善的工具链Windows 有好用的编辑器和生态。这篇文章是我自己搭建这套双系统远程开发环境的完整记录包括 SSH 远程连接、VSCode Remote 开发、Samba 文件共享以及过程中踩过的一些坑。希望能帮到同样在折腾环境的朋友。整体思路Ubuntu 跑编译工具链 → SSH 让 Windows 远程连进去写代码 → Samba 让 Windows 直接访问 Ubuntu 的文件目录。三者配合就是一套完整的远程开发工作流。一、Ubuntu 环境搭建1.1 系统要求项目最低要求推荐配置系统版本Ubuntu 18.04Ubuntu 22.04 LTS内存8 GB16 GB 及以上硬盘100 GB200 GB 及以上⚠️用户名不能含中文Ubuntu 的用户名如果包含中文字符后续编译工具链、SSH、Samba 全都会出各种莫名其妙的路径问题。装系统的时候就用纯英文用户名省得后面返工。 没有 Ubuntu 物理机在 Windows 上用 VMware / VirtualBox 跑个虚拟机完全 OK我就是这么搞的。给虚拟机分配至少 8GB 内存 100GB 硬盘编译起来才不会卡到怀疑人生。1.2 将 Shell 环境切换为 bashUbuntu 默认的 Shell 可能是 dash但很多编译脚本依赖 bash 的语法特性所以第一步就是把 Shell 切到 bash。步骤一先看看当前的 Shell 是不是 bashls-l/bin/sh如果输出结果是/bin/sh - bash说明已经是 bash 了直接跳到第二节。如果显示的是dash继续下一步。步骤二执行以下命令将 Shell 从 dash 切换为 bashsudodpkg-reconfigure dash输入密码后会弹出一个蓝底的选择界面选择No按回车确认。这样 Shell 就从 dash 切到 bash 了。可以再跑一次ls -l /bin/sh验证一下确认输出已经变成 bash。二、Windows 环境搭建2.1 系统要求项目要求系统Windows 10 64 位内存8 GB 及以上硬盘100 GB 及以上2.2 安装 VSCodeWindows 这边核心就一个工具——Visual Studio Code。去官网下载安装包一路 Next 装好就行。 安装时记得勾选「添加到 PATH」选项方便后面从命令行直接用code .打开项目。三、SSH 远程访问配置要让 Windows 能远程连到 UbuntuUbuntu 侧需要先装好 SSH 服务然后拿到 Ubuntu 的 IP 地址。3.1 Ubuntu 侧安装 SSH 服务步骤一安装 OpenSSH Serversudoapt-getinstallopenssh-server步骤二启动 SSH 服务sudosystemctl startssh步骤三安装 net-tools 并获取 IP 地址sudoapt-getinstallnet-toolsifconfig在ifconfig的输出里找到ens33或eth0网段下的inet地址比如192.168.xxx.xxx这就是 Ubuntu 的 IP。记下来后面 Windows 连接要用。⚠️ 如果 Ubuntu 是虚拟机确保网络模式是桥接模式或者NAT 端口转发不然 Windows 根本 ping 不通 Ubuntu 的 IP。这个坑我踩过搞了半天发现是网络模式的问题 。四、VSCode Remote-SSH 远程连接SSH 服务配好后就可以用 VSCode 的 Remote-SSH 插件远程连到 Ubuntu 了。连上之后你在 Windows 的 VSCode 里写代码实际编译运行都在 Ubuntu 上体验和本地开发几乎一样。4.1 Windows 侧安装 Remote-SSH 插件步骤一打开 Windows 上的 VSCode点击左侧活动栏的扩展图标或者按CtrlShiftX。步骤二在搜索框输入Remote-SSH找到 Microsoft 出的那个点Install安装。步骤三安装完成后VSCode 左侧活动栏会多出一个Remote Explorer图标说明插件装好了。4.2 配置 SSH 连接步骤一按F1打开命令面板输入Remote-SSH选择Remote-SSH: Add New SSH Host。步骤二在弹出的输入框中填写 SSH 连接命令ssh usernameip_address把username换成你的 Ubuntu 用户名ip_address换成上一步拿到的 IP 地址。比如ssh wangqing192.168.1.100。步骤三选择 SSH 配置文件保存位置选默认的第一个选项通常是C:\Users\你的用户名\.ssh\config就行。步骤四在左侧 SSH TARGETS 列表中找到刚添加的远程主机点击右侧的Connect按钮或者点旁边的图标在新窗口连接。步骤五弹窗中选择Linux作为远程平台类型然后点Continue接受指纹认证。步骤六输入 Ubuntu 的登录密码等待连接建立。✅ 连接成功后VSCode 左下角会显示一个绿色的 SSH 标识旁边是远程机器的 IP 地址。第一次连接会在 Ubuntu 的~/.vscode-server目录下自动安装 VSCode Server 组件需要等几分钟之后就快了。进阶小技巧每次输密码太烦可以配置 SSH 密钥免密登录。在 Windows 终端执行ssh-keygen -t ed25519生成密钥对然后用ssh-copy-id usernameip_address把公钥传到 Ubuntu 上。之后连就不用输密码了。五、Samba 服务器配置SSH 解决了远程写代码的问题但有时候我们需要在 Windows 下直接访问 Ubuntu 的文件目录比如烧录的时候需要拿到镜像文件这时候就轮到 Samba 登场了。5.1 Ubuntu 侧安装并配置 Samba步骤一安装 Sambasudoapt-getinstallsamba samba-common步骤二编辑 Samba 配置文件sudogedit /etc/samba/smb.conf在配置文件末尾添加以下内容根据实际情况修改路径和用户名# [ShareName] 是在 Windows 中映射后看到的文件夹名称 [ShareName] comment Shared Folder # 共享信息说明 path /home/username/share # 共享目录的绝对路径 valid users username # 可以访问的 Ubuntu 用户名 directory mask 0775 # 默认创建目录的权限 create mask 0775 # 默认创建文件的权限 public yes # 是否公开访问 writable yes # 是否可写 available yes # 是否可获取 browseable yes # 是否可浏览⚠️ 上面配置里的[ShareName]、path、valid users这三项一定要改成你自己的。path指定的目录要提前用mkdir创建好否则 Samba 启动会报错。步骤三设置 Samba 访问密码sudosmbpasswd-ausername# username 替换为你的 Ubuntu 用户名输入命令后根据提示设置 Samba 访问密码。这个密码和系统登录密码是独立的可以设成一样的方便记忆。步骤四重启 Samba 服务让配置生效sudoservicesmbd restart六、Windows 映射网络驱动器Samba 服务器配好后在 Windows 这边把共享目录映射成本地网络驱动器就能像访问本地磁盘一样操作 Ubuntu 的文件了。步骤一在 Windows 桌面找到**「此电脑」**或「计算机」右键选择映射网络驱动器。步骤二在弹出的窗口中选择一个盘符比如Z:然后在文件夹输入框中填写 Samba 共享路径\\192.168.xxx.xxx\ShareNameIP 地址填 Ubuntu 的 IPShareName就是你在smb.conf里方括号中写的名称。步骤三点完成后会弹出认证窗口输入刚才设置的 Samba 用户名和密码。勾选「记住凭据」可以免重复输入。步骤四映射成功后打开「此电脑」就能看到一个新的网络驱动器盘符。点进去就是 Ubuntu 的共享目录可以直接拖拽文件、编辑、删除就跟本地磁盘一样。 到这里整套环境就搭建完成了总结一下最终效果VSCode 通过 Remote-SSH 远程编辑 Ubuntu 上的代码 → 编译在 Ubuntu 上完成 → Samba 共享让 Windows 直接访问产物文件 → 烧录工具在 Windows 下直接读取。完整闭环。七、常见问题与踩坑记录7.1 SSH 连接超时 / 拒绝连接可能原因解决方案SSH 服务没启动sudo systemctl start ssh防火墙拦截sudo ufw allow 22开放 22 端口虚拟机网络模式不对改为桥接模式或配置端口转发IP 地址变了重新ifconfig确认建议在路由器里绑定固定 IP7.2 VSCode Remote 连接后卡在 Setting Up SSH Host通常是首次连接时 VSCode Server 下载太慢。可以手动下载对应平台的vscode-server压缩包放到 Ubuntu 的~/.vscode-server/bin/目录下解压。或者给 Ubuntu 配个代理加速下载。7.3 Samba 共享无法访问 / 权限拒绝检查smb.conf里的path目录是否存在用mkdir -p提前创建检查valid users是否和smbpasswd -a设置的用户一致确认 Samba 服务已重启sudo service smbd restartWindows 侧清除旧凭据打开「凭据管理器」→ Windows 凭据 → 删除旧的 Samba 记录7.4 网络驱动器映射后无法写入检查smb.conf中writable yes是否配置以及 Ubuntu 侧共享目录的权限chmod-R775/home/username/share7.5 Ubuntu 用户名包含中文导致各种路径报错 这个是最坑的。如果已经装好系统了才发现用户名有中文最省事的方案是新建一个纯英文用户把开发环境迁移过去。改用户名涉及大量系统文件路径变更风险很高不推荐。总结整套环境搭建的核心就三件事步骤工具作用1. Shell 切 bashdpkg-reconfigure保证编译脚本兼容性2. SSH 远程连接openssh-server Remote-SSHWindows 远程编辑 Ubuntu 代码3. Samba 文件共享samba 网络驱动器映射Windows 直接访问 Ubuntu 文件搭好之后日常开发就是打开 VSCode → 自动连上 Ubuntu → 写代码 → 终端编译 → Windows 下烧录。丝滑 如果遇到问题先翻翻第七节的踩坑记录基本覆盖了常见的几个坑。祝搭建顺利