1. 项目缘起为什么要在麒麟系统上折腾开发环境最近几年国产操作系统在政企、金融、教育等领域的应用越来越广泛其中麒麟系列包括银河麒麟、中标麒麟等作为主流选择很多开发者都不可避免地需要与之打交道。无论是做适配、迁移还是日常在麒麟系统上进行开发一个顺手、稳定、通用的开发环境是高效工作的基石。但说实话从零开始在麒麟系统上搭建一套完整的开发环境对于习惯了Windows或主流Linux发行版如Ubuntu、CentOS的开发者来说确实会遇到不少“水土不服”的情况。我自己就经历过好几次项目要求必须在银河麒麟V10上部署和调试一个Java Web应用。一开始以为和CentOS差不多结果从安装JDK、配置Maven到部署MySQL、安装Node.js每一步都踩了坑。包管理器不一样、依赖库名称有差异、甚至一些编译工具链的版本都让人头疼。网上资料零散很多教程直接照搬Ubuntu的命令在麒麟上根本跑不通。折腾了两三天环境才算勉强能用但心里总不踏实。所以我决定结合自己的多次实战经验整理一份在麒麟系统以银河麒麟V10 SP1桌面版为例下从零搭建一套通用开发环境的详细指南。这套环境的目标是覆盖后端Java/Python/Go、前端Node.js、数据库MySQL/Redis以及常用工具Git、Docker等力求做到步骤清晰、命令可复制、避坑点明确。无论你是需要为国产化项目做适配还是单纯想在麒麟系统上写代码这篇长文都能帮你省下大量摸索的时间。2. 搭建前的核心准备理解麒麟系统的“特殊性”在动手之前我们必须先搞清楚麒麟系统这里主要指银河麒麟和常见的Linux发行版有什么不同。盲目套用Ubuntu或CentOS的经验是失败的第一步。2.1 麒麟系统的版本与源管理银河麒麟基于Linux内核但其软件包管理体系并非直接采用APTDebian/Ubuntu或YUMRHEL/CentOS而是有自己的kydroid命令和apt深度定制版。更重要的是系统的软件源repository默认可能不包含丰富的开发工具。首先确认你的系统版本cat /etc/os-release输出会包含类似PRETTY_NAMEKylin V10 SP1的信息。不同版本如V10 V10 SP1和架构x86_64, aarch64在后续步骤中会有细微差别。最关键的一步配置可用的软件源。麒麟系统默认的源可能速度慢或软件不全。我们可以尝试添加国内镜像源或兼容源如USTC、阿里云为openEuler或CentOS提供的源麒麟与之有较好的兼容性。但这里有个大坑直接替换源可能导致系统关键组件冲突。更稳妥的做法是新增源而不是替换。例如对于x86_64架构的银河麒麟V10可以尝试添加华为openEuler的EPEL源作为补充# 备份原有源列表 sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak # 使用编辑器如vim打开源列表在文件末尾添加 sudo vim /etc/apt/sources.list # 添加以下内容以华为云镜像为例注意版本匹配 deb https://repo.huaweicloud.com/openeuler/openEuler-20.03-LTS-SP1/EPOL/main/ aarch64 main # 注意上面的URL是示例你需要根据你的麒麟系统实际基于的上游可能是openEuler或Fedora和架构查找正确的源。重要提示实际上更安全、更推荐的方法是使用麒麟官方或其合作方提供的扩展源。建议优先在麒麟软件商店或官网社区查找“开发工具套件源”或“第三方软件源”的配置方法。如果找不到一个万金油的方法是优先使用系统自带的“软件商店”和“终端命令sudo apt update后能搜索到的包实在没有的再考虑通过编译安装或下载官方二进制包的方式。2.2 基础系统更新与必备组件无论源如何配置第一步都应该是更新系统并安装一些编译和基础工具这些工具在后续安装其他软件时几乎是必需的。# 1. 更新软件包列表 sudo apt update # 2. 升级已安装的包这步可能耗时较长建议在网络好时进行 sudo apt upgrade -y # 3. 安装开发基础工具链 sudo apt install -y build-essential # 包含gcc, g, make等 sudo apt install -y curl wget vim git tar gzip bzip2 sudo apt install -y net-tools openssh-server # 网络和远程连接工具 sudo apt install -y libssl-dev zlib1g-dev libreadline-dev # 常见开发库安装完成后可以通过gcc --version和git --version验证是否成功。这一步如果遇到大量依赖问题可能意味着软件源配置有问题需要回头检查。3. 核心开发语言环境搭建一个通用的开发环境至少需要Java、Python和Node.js。下面我们分别安装。3.1 Java开发环境JDK安装与配置麒麟系统的软件仓库里可能有OpenJDK但版本可能较旧。对于需要特定版本如JDK 8, 11, 17的项目建议从官网下载安装。方案一通过APT安装简单但版本受限# 搜索可用的JDK包 sudo apt search openjdk # 通常可以安装openjdk-11-jdk sudo apt install -y openjdk-11-jdk安装后用java -version检查。方案二手动安装Oracle JDK或特定版本OpenJDK推荐访问Oracle官网或AdoptiumEclipse Temurin官网下载对应架构x64或ARM64的JDK压缩包.tar.gz。假设下载了jdk-17.0.8_linux-x64_bin.tar.gz。# 创建安装目录 sudo mkdir -p /usr/lib/jvm # 解压到该目录 sudo tar -xzf jdk-17.0.8_linux-x64_bin.tar.gz -C /usr/lib/jvm/ # 配置环境变量编辑~/.bashrc如果使用zsh则是~/.zshrc vim ~/.bashrc在文件末尾添加export JAVA_HOME/usr/lib/jvm/jdk-17.0.8 export PATH$JAVA_HOME/bin:$PATH使配置生效并验证source ~/.bashrc java -version which java踩坑点麒麟系统有时会预装其他版本的Java导致java -version显示的不是你刚安装的。可以使用sudo update-alternatives --config java来管理和切换系统默认的Java版本。3.2 Python开发环境搭建系统可能自带Python 3但版本可能不是最新的且缺乏pip和一些关键头文件。# 1. 安装Python3、pip3及开发依赖 sudo apt install -y python3 python3-pip python3-dev python3-venv # 2. 升级pip到最新版国内建议使用镜像源 pip3 install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple # 3. 安装虚拟环境工具强烈推荐用于隔离项目依赖 pip3 install virtualenv virtualenvwrapper配置virtualenvwrapper方便管理虚拟环境# 编辑 ~/.bashrc vim ~/.bashrc # 添加以下内容 export WORKON_HOME$HOME/.virtualenvs export VIRTUALENVWRAPPER_PYTHON/usr/bin/python3 source /usr/local/bin/virtualenvwrapper.sh然后执行source ~/.bashrc。之后就可以用mkvirtualenv my_project创建虚拟环境了。经验之谈在麒麟系统上用python3和pip3命令是最稳妥的。有些软件包在ARM架构如飞腾CPU上可能需要从源码编译如果遇到编译错误通常需要安装更完整的开发库如sudo apt install -y build-essential libffi-dev libsqlite3-dev。3.3 Node.js与前端环境搭建麒麟的仓库里Node.js版本可能很旧。我们使用NodeSource提供的仓库来安装LTS版本。# 1. 安装NodeSource仓库脚本以Node.js 18.x LTS为例 curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - # 2. 安装Node.js sudo apt install -y nodejs # 3. 验证安装 node --version npm --version配置npm国内镜像加速npm config set registry https://registry.npmmirror.com安装Yarn可选但推荐# 通过npm安装 sudo npm install -g yarn # 验证 yarn --version注意上述curl ... | sudo bash命令存在一定安全风险因为它会从网络下载并执行脚本。在可信的网络环境下使用。如果公司内网有严格限制可以考虑下载Node.js的二进制包进行手动安装步骤类似JDK。4. 数据库与中间件安装开发离不开数据库。这里介绍MySQL和Redis的安装。4.1 MySQL数据库安装麒麟系统的仓库里可能叫mysql-server或mariadb-server。以MySQL 8.0为例如果仓库没有可以从MySQL官网下载RPM包转换或使用通用二进制包。方案一通过APT安装MariaDBMySQL的替代品兼容性好sudo apt install -y mariadb-server mariadb-client sudo systemctl start mariadb sudo systemctl enable mariadb安装后运行sudo mysql_secure_installation进行安全初始化设置root密码等。方案二安装官方MySQL步骤稍复杂去MySQL官网下载适用于Linux通用版的mysql-8.0.xx-linux-glibc2.17-x86_64.tar.xz二进制包。参考官方文档或JDK的安装方式解压到/usr/local/mysql创建mysql用户和组初始化数据目录配置环境变量和启动脚本。强烈建议对于开发环境方案一MariaDB足矣省心省力。除非项目强制要求必须用官方MySQL特定版本。4.2 Redis内存数据库安装Redis的安装相对简单。# 1. 安装Redis sudo apt install -y redis-server # 2. 启动并设置开机自启 sudo systemctl start redis-server sudo systemctl enable redis-server # 3. 检查状态 sudo systemctl status redis-server # 使用redis-cli连接测试 redis-cli ping # 应该返回 PONG基础配置默认Redis只监听本地127.0.0.1且无密码。对于开发环境这通常可以接受。如果需要远程连接或密码需编辑/etc/redis/redis.conf文件修改bind和requirepass配置项然后重启服务。5. 版本控制与容器化工具5.1 Git及其图形化客户端Git通常已包含在基础工具里。我们进行一些基础配置并安装一个图形化工具。# 配置全局用户信息 git config --global user.name Your Name git config --global user.email your.emailexample.com # 安装图形化工具如GitKraken或使用VSCode插件这里安装一个轻量的 sudo apt install -y gitk git-gui5.2 Docker与Docker Compose在麒麟系统上安装Docker需要一些技巧因为Docker官方主要支持Ubuntu、Debian、CentOS等。麒麟系统可能与某个上游发行版兼容。步骤一确定系统基础库兼容性# 查看系统内核和架构 uname -r uname -mDocker需要内核版本3.10以上麒麟V10通常满足。步骤二尝试使用上游发行版的安装脚本以Ubuntu为例如果麒麟基于Debian/Ubuntu# 卸载旧版本如果有 sudo apt remove docker docker-engine docker.io containerd runc # 安装依赖允许apt通过HTTPS使用仓库 sudo apt install -y apt-transport-https ca-certificates curl software-properties-common # 添加Docker官方GPG密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - # 添加Docker仓库这里假设麒麟兼容Ubuntu 20.04的仓库这是一个关键假设点 sudo add-apt-repository deb [archamd64] https://download.docker.com/linux/ubuntu focal stable # 对于ARM架构如飞腾需要将archamd64改为archarm64并且仓库地址可能不同。 # 更新并安装Docker CE sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io这是最大的坑点add-apt-repository这一行很可能失败因为Docker的仓库不认识“kylin”这个发行版标识。如果失败说明此路不通。备用方案使用通用安装脚本或下载二进制包使用官方便捷脚本不推荐生产环境但开发环境可试curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh这个脚本会自动检测系统并尝试安装。在麒麟上成功率较高但并非100%。手动下载二进制包安装从Docker官网下载静态二进制包docker-version.tgz解压后复制到/usr/bin/并手动配置systemd服务文件。步骤繁琐但最可控。步骤三安装Docker ComposeDocker Compose V2已集成在Docker CLI插件中。如果通过包管理器安装了Docker通常可以sudo apt install -y docker-compose-plugin验证docker compose version步骤四配置用户组避免每次用sudosudo groupadd docker # 如果docker组已存在会提示 sudo usermod -aG docker $USER newgrp docker # 刷新组权限或需要重新登录 # 测试 docker run hello-world如果hello-world能成功运行恭喜你Docker安装成功。这是麒麟系统上比较有挑战性的一步需要耐心和搜索能力。6. 集成开发环境IDE与常用工具命令行工具齐备后需要一个好用的代码编辑器。6.1 Visual Studio Code 安装VS Code官方提供了.deb和.rpm包麒麟系统x86通常可以安装.deb包。从VS Code官网下载.deb包。安装sudo dpkg -i code_*.deb # 如果报依赖错误运行 sudo apt install -f安装后可以在应用菜单找到或命令行输入code启动。注意对于ARM架构的麒麟系统如飞腾平台需要下载VS Code的ARM64版本或者使用开源替代品如VSCodium或者考虑使用JetBrains系列IDE如IntelliJ IDEA, PyCharm它们对ARM架构的支持较好。6.2 其他实用工具PostmanAPI测试工具。可以从官网下载Linux版.tar.gz包解压后运行Postman可执行文件或创建桌面快捷方式。文件传输FileZilla是一个好用的FTP/SFTP客户端可以通过sudo apt install filezilla安装。终端增强推荐使用zsh和oh-my-zsh。sudo apt install -y zsh sh -c $(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh) # 安装插件如语法高亮和自动补全 git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions # 编辑 ~/.zshrc修改 plugins(git zsh-autosuggestions zsh-syntax-highlighting)7. 环境配置优化与问题排查环境装好了还需要打磨一下才好用。7.1 Shell环境变量统一管理建议将所有的环境变量JAVA_HOME, PATH等都集中配置在~/.bashrc或~/.zshrc中并做好注释。例如# 开发环境变量 export JAVA_HOME/usr/lib/jvm/jdk-17.0.8 export NODE_HOME/usr/local/node # 如果你手动安装了Node.js export PATH$JAVA_HOME/bin:$NODE_HOME/bin:$PATH # Python虚拟环境wrapper export WORKON_HOME$HOME/.virtualenvs export VIRTUALENVWRAPPER_PYTHON/usr/bin/python3 source /usr/local/bin/virtualenvwrapper.sh # 别名 alias llls -alF alias dpsdocker ps --format \table {{.ID}}\\t{{.Names}}\\t{{.Status}}\\t{{.Ports}}\7.2 系统级配置调整取消密钥环提示有时开机或连接某些服务会弹窗提示输入“密钥环”密码。可以将其密码设为空。# 找到登录密钥环将其密码修改为与登录密码一致或设为空安全性降低仅开发环境 # 或者直接禁用在“应用程序”-“附件”-“密码和密钥”中右键“登录”密钥环选择“更改密码”输入旧密码新密码留空。字体与显示如果觉得系统字体不清晰可以下载并安装“微软雅黑”、“思源黑体”等字体。将字体文件.ttf复制到~/.fonts/目录然后运行fc-cache -fv刷新缓存。输入法卡顿这是麒麟系统一个常见问题。可以尝试切换输入法框架如使用Fcitx5替代默认的iBus或者在输入法设置中关闭一些高级功能如云输入。7.3 常见问题与排查思路sudo apt update失败提示“无法定位软件包”或“Release文件过期”原因软件源配置错误或网络不通。解决检查/etc/apt/sources.list文件中的源地址是否能ping通。尝试更换为国内镜像源如华为、清华、阿里云针对openEuler的源并确认版本匹配。最保守的方法是只保留麒麟官方源缺失的软件通过编译或二进制包安装。编译软件时提示“找不到 -lxxx”库原因缺少对应的开发库-dev包。解决使用apt search libxxx查找对应的开发包通常是libxxx-dev或xxx-devel。例如找不到-lssl就安装libssl-dev。Docker容器内无法解析域名原因Docker容器的DNS配置问题。解决编辑Docker守护进程配置/etc/docker/daemon.json没有则创建添加DNS服务器{ dns: [8.8.8.8, 114.114.114.114] }然后重启Dockersudo systemctl restart docker。图形化软件无法启动或报GLib-GIO相关错误原因桌面环境或依赖库问题。解决尝试在终端中启动软件查看具体错误。可能是缺少某个GTK或Qt库使用apt安装对应依赖。有时是因为使用了root权限运行了图形程序导致权限冲突。8. 实战演练搭建一个简单的Web应用全栈环境为了验证我们的环境是否真正可用我们来快速搭建一个“待办事项”全栈应用。后端Python Flask MySQL创建项目目录并进入mkdir todo_app cd todo_app创建虚拟环境并激活python3 -m venv venv source venv/bin/activate安装Flask和MySQL驱动pip install flask pymysql编写一个简单的app.py省略详细代码包含连接MySQL、创建表、提供REST API。确保MySQL服务已启动并创建数据库和用户。前端Vue.js在另一个终端使用Vue CLI创建前端项目npm install -g vue/cli vue create todo-frontend cd todo-frontend npm run serve编写组件调用后端的API。使用Docker Compose编排可选但推荐 创建一个docker-compose.yml文件定义MySQL、后端、前端三个服务并配置网络和卷。这样只需要docker compose up就能一键启动整个应用栈。通过这个实战你可以全面测试Python环境、Node环境、MySQL、Docker以及代码编辑器的协同工作能力。遇到问题就回到前面相应的章节去排查。环境搭建从来不是一劳永逸的事情尤其是在麒麟这样一个快速迭代且生态相对特殊的系统上。核心思路是优先使用系统认可的方式软件商店、官方源其次寻找兼容的第三方源最后才考虑手动编译或二进制安装。保持耐心善用搜索引擎和社区如“银河麒麟社区论坛”大部分问题都能找到解决方案。这份指南提供了一条相对清晰的路径和众多避坑点希望能帮你少走弯路把精力更多地投入到创造性的开发工作中去。
langchain v1.0(deep agent详细学习(6)`frontend`))
