Renaming Source Files and Projects
There are several methods of renaming files and projects, depending what the
result shall be.
In any case, you will have to open the Solution Explorer window.
If it is not open, press
The main .ino file, the containing folder on your hard
disk and the project must always have matching names.
Do not rename the project (Red 'x' above),
Rename the main .ino file instead, as shown below. This will rename the
project and the disk folder as well.
If you want to rename the project and the containing folder...
Click on the main source file (blink.ino
in our example), it is the one containing the setup()
and loop() functions, this file has the same name as the project. Press
[F2] and give the source file a new name. This will also rename the
project and the containing folder on your hard disk, so that all fit
If you want to rename a single source file...
Click on the source file, press [F2] and give the source file a
new name. If this was the "main" file containing the setup() and loop()
functions, the project will be renamed as well, see above.
If it was any other file, only the file will be renamed.
If the source file has a matching header file (like "somefile.cpp" and "somefile.h"),
then it is recommended to also rename the header file and the
#include statements that reference it, so that you will
have a pair of files with matching file names again.
If you want to rename a single header (.h) file...
Open the "Header Files" node in Solution Explorer and rename the
file in the same way as for source files.
Do not forget to change all #include references
to your header file in all source files where it is used.
If you have a situation where the containing folder, the
main .ino file and the project have mismatched names, here is how you
put everything in order:
- Rename the project by clicking on the project name, pressing [F2]
and renaming the project
- In Solution Explorer, select the main
.ino file, press F2 and rename it to match the name of the project
- Close the solution with File > Close Solution
- Open Windows Explorer, rename the disk folder
- Reopen the Solution with File > Recent Projects and