rc-dock使用指南：高效管理多项目开发环境

核心价值：为什么选择rc-dock？

在多项目并行开发时，你是否遇到过这些问题：切换项目时配置文件冲突、开发环境依赖版本不一致、服务启动参数混乱？rc-dock作为轻量级Dock管理工具（进程管理中枢），通过统一的配置管理和环境隔离，帮助开发者在复杂工作流下保持高效生产力。其核心优势在于：

• 环境隔离：为不同项目创建独立配置空间
• 快速切换：一键切换项目开发环境
• 配置复用：共享通用配置模板，减少重复劳动

快速上手：5分钟启动rc-dock

1️⃣ 准备工作

确保系统已安装Node.js（v14+）和npm/yarn包管理器。通过以下命令克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/rc/rc-dock
cd rc-dock

2️⃣ 安装依赖

执行依赖安装命令，自动解析package.json中的依赖项：

npm install
# 或使用yarn
yarn install

3️⃣ 启动服务

🔥 执行启动命令，系统将自动加载默认配置并启动Dock服务：

npm start

首次启动会生成默认配置文件，服务默认运行在3000端口

深度配置：3步打造个性化开发环境

核心目录解析

rc-dock采用极简目录结构，仅需关注三个核心目录：

目录	功能描述	关键文件
src/	核心功能实现	main.js（程序入口）
config/	环境配置中心	config.default.js（默认配置）
scripts/	操作脚本集	start.js（启动脚本）

扩展功能模块：包含工具脚本、样式文件等辅助组件，满足进阶需求

配置文件实战

rc-dock采用分层配置机制，支持环境差异化设置：

配置项	默认值	自定义方案	应用场景
port	3000	3001-65535	端口冲突时修改
environment	development	production/test	部署环境切换
logLevel	info	debug/warn/error	问题排查时调整日志详细度

配置覆盖方法

创建config/config.local.js文件覆盖默认配置：

// 仅覆盖需要修改的配置项
module.exports = {
  port: 3001,
  environment: 'production'
};

⚠️ 常见配置陷阱

• 配置文件必须使用UTF-8编码
• 修改端口后需同步更新防火墙规则
• 生产环境下必须设置NODE_ENV=production环境变量

环境变量优先级说明

配置加载遵循以下优先级（从高到低）：

1. 启动命令行参数（如npm start --port=3002）
2. 系统环境变量（如export RC_PORT=3003）
3. config.local.js（用户自定义配置）
4. config.default.js（项目默认配置）

问题解决方案库

Q：如何解决"端口被占用"错误？

A：有三种解决方案：

1. 临时指定端口：npm start -- --port=3004
2. 修改配置文件：在local.js中设置port参数
3. 环境变量设置：export RC_PORT=3005 && npm start

Q：如何共享配置给团队成员？

A：创建config/config.template.js作为模板，团队成员在此基础上创建local.js，确保.gitignore中已排除local.js文件

Q：启动时报"依赖缺失"如何处理？

A：执行npm install --force强制重新安装依赖，或删除node_modules目录后重新安装

使用建议

1. 为不同项目创建独立的配置文件（如config/projectA.local.js），通过环境变量切换：RC_CONFIG=projectA npm start
2. 定期备份配置文件，避免系统重装导致配置丢失
3. 生产环境部署时，建议通过环境变量注入敏感配置（如API密钥）

通过rc-dock的环境隔离和配置管理能力，开发者可以专注于业务逻辑实现，减少环境配置带来的心智负担。无论是个人开发还是团队协作，rc-dock都能提供一致且高效的开发体验。